접근성 테스트

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

귀하의 애플리케이션이 웹 인터페이스를 제공하는 경우,

GitLab CI/CD를 사용하여 보류 중인 코드 변경 사항의 접근성 영향을 확인할 수 있습니다.

Pa11y는 웹 사이트의 접근성을 측정하기 위한 무료 오픈 소스 도구입니다.

GitLab은 Pa11y를 CI/CD 작업 템플릿에 통합합니다.

a11y 작업은 정의된 웹 페이지 집합을 분석하고, 접근성 위반, 경고 및 알림을 accessibility라는 파일에 보고합니다.

Pa11y는 WCAG 2.1 규칙을 사용합니다.

접근성 병합 요청 위젯

GitLab은 병합 요청 위젯 영역에 접근성 보고서를 표시합니다:

접근성 병합 요청 위젯

접근성 테스트 구성

GitLab CI/CD를 사용하여 Pa11y를 실행할 수 있습니다.

GitLab 접근성 Docker 이미지를 사용하세요.

a11y 작업을 정의하려면:

  1. 귀하의 GitLab 설치에서 Accessibility.gitlab-ci.yml 템플릿포함하세요.

  2. .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"
    
  3. Pa11y로 테스트할 웹 페이지의 URL 목록을 정의하려면 a11y_urls 변수를 사용자 지정하세요.

CI/CD 파이프라인의 a11y 작업은 다음 파일을 생성합니다:

  • a11y_urls 변수에 나열된 각 URL에 대해 HTML 보고서 1개.

  • 수집된 보고서 데이터를 포함하는 1개의 파일. 이 파일은 gl-accessibility.json이라는 이름입니다.

브라우저에서 작업 아티팩트를 볼 수 있습니다.

note
템플릿에서 제공하는 작업 정의는 Kubernetes를 지원하지 않습니다.

CI 구성에 Pa11y로 구성을 전달할 수 없습니다.

구성을 변경하려면 CI 파일에서 템플릿을 복사하여 편집하세요.