GitLab Pages에서 Netlify 스타일 HTTP 리다이렉트를 사용하여 하나의 URL에서 다른 URL로 전달하는 규칙을 구성할 수 있습니다.

Netlify에서 제공하는 모든 특별 옵션이 지원되는 것은 아닙니다.

리다이렉트 만들기#

리다이렉트를 만들려면 GitLab Pages 사이트의 public/ 디렉토리에 _redirects라는 구성 파일을 만듭니다.

• 모든 경로는 슬래시 /로 시작해야 합니다.

• 상태 코드가 제공되지 않으면 기본 상태 코드 301이 적용됩니다.

• _redirects 파일에는 파일 크기 제한과 프로젝트당 최대 규칙 수가 있으며, 인스턴스에 대해 구성됩니다. 구성된 최대값 내에서 처음 일치하는 규칙만 처리됩니다. 기본 파일 크기 제한은 64 KB이고 기본 최대 규칙 수는 1,000개입니다.

• GitLab Pages 사이트가 기본 도메인 이름(예: namespace.gitlab.io/project-slug)을 사용하는 경우 모든 규칙 앞에 경로를 붙여야 합니다:

  /project-slug/wardrobe.html /project-slug/narnia.html 302
  

• GitLab Pages 사이트가 사용자 정의 도메인을 사용하는 경우 프로젝트 경로 접두사가 필요하지 않습니다. 예를 들어 사용자 정의 도메인이 example.com인 경우 _redirects 파일은 다음과 같습니다:

  /wardrobe.html /narnia.html 302
  

파일이 리다이렉트보다 우선#

파일이 리다이렉트보다 우선합니다. 파일이 디스크에 존재하면 GitLab Pages는 리다이렉트 대신 파일을 제공합니다. 예를 들어 hello.html 및 world.html 파일이 존재하고 _redirects 파일에 다음 줄이 포함된 경우, hello.html이 존재하므로 리다이렉트가 무시됩니다:

/project-slug/hello.html /project-slug/world.html 302

GitLab은 이 동작을 변경하기 위한 Netlify force 옵션을 지원하지 않습니다.

HTTP 상태 코드#

상태 코드가 제공되지 않으면 기본 상태 코드 301이 적용되지만, 직접 설정할 수도 있습니다. 다음 HTTP 코드가 지원됩니다:

• 301: 영구 리다이렉트.
• 302: 임시 리다이렉트.
• 200: HTTP 요청 성공에 대한 표준 응답. Pages는 URL 표시줄의 URL을 변경하지 않고 to 규칙의 콘텐츠를 제공합니다(존재하는 경우).

리다이렉트#

리다이렉트를 만들려면 from 경로, to 경로 및 HTTP 상태 코드를 포함하는 규칙을 추가합니다:

# 301 permanent redirect
/old/file.html /new/file.html 301

# 302 temporary redirect
/old/another_file.html /new/another_file.html 302

리라이트#

요청이 from과 일치하면 to 경로의 콘텐츠를 제공하기 위해 상태 코드 200을 제공합니다:

/old/file.html /new/file.html 200

이 상태 코드는 URL을 동적으로 재작성하기 위해 스플랫 규칙과 조합하여 사용할 수 있습니다.

도메인 수준 리다이렉트#

도메인 수준 리다이렉트를 만들려면 다음에 도메인 수준 경로(http:// 또는 https://로 시작)를 추가합니다:

• to 경로만.
• from 및 to 경로 모두.

지원되는 HTTP 상태 코드는 301 및 302입니다:

# 301 permanent redirect
http://blog.example.com/file_1.html https://www.example.com/blog/file_1.html 301
/file_2.html https://www.example.com/blog/file_2.html 301

# 302 temporary redirect
http://blog.example.com/file_3.html https://www.example.com/blog/file_3.html 302
/file_4.html https://www.example.com/blog/file_4.html 302

도메인 수준 리다이렉트는 URL 경로를 동적으로 재작성하기 위해 스플랫 규칙(스플랫 플레이스홀더 포함)과 조합하여 사용할 수 있습니다.

스플랫#

from 경로에 별표(*)가 있는 규칙은 스플랫이라고 하며, 요청된 경로의 시작, 중간 또는 끝에 있는 모든 것과 일치합니다. 이 예시는 /old/ 뒤의 모든 것과 일치하고 /new/file.html로 재작성합니다:

/old/* /new/file.html 200

스플랫 플레이스홀더#

규칙의 from 경로에서 *와 일치하는 콘텐츠는 :splat 플레이스홀더를 사용하여 to 경로에 삽입할 수 있습니다:

/old/* /new/:splat 200

이 예시에서 /old/file.html에 대한 요청은 /new/file.html의 콘텐츠를 200 상태 코드와 함께 제공합니다.

규칙의 from 경로에 여러 스플랫이 포함된 경우, 첫 번째 스플랫 일치 값이 to 경로의 모든 :splat을 대체합니다.

스플랫 매칭 동작#

스플랫은 "탐욕적"이며 가능한 한 많은 문자와 일치합니다:

/old/*/file /new/:splat/file 301

이 예시에서 규칙은 /old/a/b/c/file을 /new/a/b/c/file로 리다이렉트합니다.

스플랫은 빈 문자열과도 일치하므로, 이전 규칙은 /old/file을 /new/file로도 리다이렉트합니다.

모든 요청을 루트 index.html로 재작성#

단일 페이지 애플리케이션(SPA)은 종종 클라이언트 측 라우트를 사용하여 자체 라우팅을 수행합니다. 이러한 애플리케이션의 경우, 라우팅 로직이 JavaScript 애플리케이션에서 처리될 수 있도록 모든 요청을 루트 index.html로 재작성합니다.

index.html로 요청을 재작성하려면:

1. 다음 _redirects 규칙을 추가합니다:

   /* /index.html 200
   

2. 단일 페이지 애플리케이션이 병렬 배포에서 작동하도록 하려면 경로 접두사를 포함하도록 리다이렉트 규칙을 편집합니다:

   /project/base/<prefix>/* /project/base/<prefix>/index.html 200
   

   <prefix>를 경로 접두사 값으로 바꾸세요.

플레이스홀더#

규칙에서 플레이스홀더를 사용하여 요청된 URL의 일부를 일치시키고 새 URL로 재작성하거나 리다이렉트할 때 이러한 일치 항목을 사용합니다.

플레이스홀더는 from 및 to 경로 모두에서 : 문자와 그 뒤에 오는 문자열([a-zA-Z]+)로 형식이 지정됩니다:

/news/:year/:month/:date/:slug /blog/:year-:month-:date-:slug 200

이 규칙은 Pages가 /news/2021/08/12/file.html에 대한 요청에 응답할 때 /blog/2021-08-12-file.html의 콘텐츠를 200으로 제공하도록 지시합니다.

플레이스홀더 매칭 동작#

스플랫과 비교하여 플레이스홀더는 일치하는 콘텐츠 양에 더 제한적입니다. 플레이스홀더는 슬래시(/) 사이의 텍스트와 일치하므로 단일 경로 세그먼트를 일치시키는 데 사용합니다.

또한 플레이스홀더는 빈 문자열과 일치하지 않습니다. 다음과 같은 규칙은 /old/file과 같은 요청 URL과 일치하지 않습니다:

/old/:path /new/:path

리다이렉트 규칙 디버그#

리다이렉트가 예상대로 작동하지 않거나 리다이렉트 구문을 확인하려면 [your pages url]/_redirects를 방문하세요. _redirects 파일은 직접 제공되지 않지만 브라우저에 리다이렉트 규칙의 번호가 매겨진 목록과 규칙이 유효한지 또는 유효하지 않은지가 표시됩니다:

11 rules
rule 1: valid
rule 2: valid
rule 3: error: splats are not supported
rule 4: valid
rule 5: error: placeholders are not supported
rule 6: valid
rule 7: error: no domain-level redirects to outside sites
rule 8: error: url path must start with forward slash /
rule 9: error: no domain-level redirects to outside sites
rule 10: valid
rule 11: valid

Netlify 구현과의 차이점#

지원되는 대부분의 _redirects 규칙은 GitLab과 Netlify 모두에서 동일하게 동작합니다. 그러나 일부 사소한 차이점이 있습니다:

• 모든 규칙 URL은 슬래시로 시작해야 합니다:

  Netlify는 URL이 슬래시로 시작하도록 요구하지 않습니다:

  # Valid in Netlify, invalid in GitLab
  */path /new/path 200
  

  GitLab은 모든 URL이 슬래시로 시작하는지 확인합니다. 이전 예시의 유효한 동등물:

  # Valid in both Netlify and GitLab
  /old/path /new/path 200
  

• 모든 플레이스홀더 값이 채워집니다:

  Netlify는 to 경로에 나타나는 플레이스홀더 값만 채웁니다:

  /old /new/:placeholder
  

  /old에 대한 요청이 주어지면:

  • Netlify는 /new/:placeholder로 리다이렉트합니다(문자 그대로의 :placeholder).
  • GitLab은 /new/로 리다이렉트합니다.