접근성 테스트
Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-Managed, GitLab Dedicated
귀하의 애플리케이션이 웹 인터페이스를 제공하는 경우, 보류 중인 코드 변경 사항의 접근성 영향을 결정하기 위해 GitLab CI/CD를 사용할 수 있습니다.
Pa11y는 웹 사이트의 접근성을 메트릭하기 위한 무료 오픈 소스 도구입니다. GitLab은 Pa11y를 CI/CD 작업 템플릿에 통합합니다. a11y
작업은 정의된 일련의 웹 페이지를 분석하고 accessibility
라는 이름의 파일에 접근성 위반, 경고 및 알림을 보고합니다.
GitLab 14.5부터 Pa11y는 WCAG 2.1 규칙을 사용합니다.
접근성 Merge Request 위젯
GitLab은 Merge Request 위젯 영역에 접근성 보고서를 표시합니다:
접근성 테스트 구성
GitLab CI/CD를 사용하여 Pa11y를 실행하려면 GitLab Accessibility Docker 이미지를 사용합니다.
a11y
작업을 정의하려면:
- 귀하의 GitLab 설치에서
Accessibility.gitlab-ci.yml
템플릿을 포함합니다. -
.gitlab-ci.yml
파일에 다음 구성을 추가합니다.stages: - accessibility variables: a11y_urls: "https://about.gitlab.com https://gitlab.com/users/sign_in" include: - template: "Verify/Accessibility.gitlab-ci.yml"
-
a11y_urls
변수를 사용하여 테스트할 웹 페이지의 URL을 나열합니다.
귀하의 CI/CD 파이프라인의 a11y
작업은 다음과 같은 파일을 생성합니다:
-
a11y_urls
변수에 나열된 각 URL에 대한 HTML 보고서 하나. - 수집된 보고 데이터를 포함하는 파일. GitLab 버전 12.11 이상에서는 이 파일의 이름이
gl-accessibility.json
입니다. GitLab 버전 12.10 이전에서는 이 파일의 이름이accessibility.json
입니다.
브라우저에서 작업 아티팩트를 확인할 수 있습니다.
템플릿에서 제공하는 작업 정의는 Kubernetes를 지원하지 않습니다.
CI 구성을 통해 Pa11y에 구성을 전달할 수 없습니다. 구성을 변경하려면 CI 파일에서 템플릿의 사본을 편집하십시오.