InfoGrab DocsInfoGrab Docs

정적 사이트를 위한 GitLab Pages 배포 만들기

요약

GitLab Pages 배포를 만들면 정적 사이트나 프레임워크를 GitLab에서 호스팅되는 웹사이트로 전환할 수 있습니다. Pages UI로 정적 사이트 또는 프레임워크 기반 애플리케이션을 배포할 수 있습니다. 애플리케이션이 public 폴더로 파일을 출력해야 합니다.

GitLab Pages 배포를 만들면 정적 사이트나 프레임워크를 GitLab에서 호스팅되는 웹사이트로 전환할 수 있습니다. 단계별 양식을 통해 GitLab은 다음을 수행합니다:

  • 프로젝트 구성에 맞춘 CI/CD 구성을 생성합니다.
  • GitLab Pages 배포에 맞게 구성된 .gitlab-ci.yml 파일을 만듭니다.
  • 검토할 수 있도록 머지 리퀘스트로 변경 사항을 제출합니다.
  • 머지 리퀘스트가 병합되면 웹사이트를 자동으로 배포합니다.

Pages UI로 정적 사이트 또는 프레임워크 기반 애플리케이션을 배포할 수 있습니다.

사전 요구 사항#

  • 애플리케이션이 public 폴더로 파일을 출력해야 합니다. 빌드 파이프라인 중에 이 폴더를 만든다면 Git에 커밋할 필요가 없습니다.

    [!warning] 이 단계는 중요합니다. 파일이 루트 수준의 public 폴더에 있는지 확인합니다.

  • 다음 중 하나에 해당하는 프로젝트가 있어야 합니다:

    • Eleventy, Astro, Jekyll처럼 정적 사이트 또는 클라이언트 렌더링 단일 페이지 애플리케이션(SPA)을 생성하는 프로젝트.
    • Next.js, Nuxt, SvelteKit처럼 정적 출력으로 구성된 프레임워크를 포함하는 프로젝트.

  • 프로젝트에서 GitLab Pages가 켜져 있어야 합니다. (켜려면 Settings > General로 이동하여 Visibility, project features, permissions를 확장한 다음 Pages 토글을 켭니다.)

Pages 배포 만들기#

설정을 완료하고 GitLab Pages 배포를 생성하려면 다음 단계를 수행합니다:

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 Deploy > Pages를 선택합니다.

    Get Started with Pages 양식이 표시됩니다. 이 양식이 표시되지 않으면 문제 해결을 참고합니다.

  3. Step 1에서 이미지 이름을 입력합니다. Pages로 배포할 사용자 지정 폴더를 설정할 수도 있습니다.

  4. Next를 선택합니다.

  5. Step 2에서 설치 단계를 입력합니다. 프레임워크의 빌드 과정에 제공된 빌드 명령 중 하나가 필요하지 않다면 다음 중 하나를 수행합니다:

    • Next를 선택하여 해당 단계를 건너뜁니다.
    • 그 단계의 기본 골격을 .gitlab-ci.yml 파일에 그대로 포함하려면 :(아무 동작도 하지 않는 bash 명령)를 입력합니다.

  6. Next를 선택합니다.

  7. Step 3에서 애플리케이션을 빌드하는 방법을 나타내는 스크립트를 입력합니다.

  8. Next를 선택합니다.

  9. 선택 사항. 생성된 .gitlab-ci.yml 파일을 필요에 맞게 편집합니다.

  10. Step 4에서 커밋 메시지를 추가하고 Commit을 선택합니다. 이 커밋이 첫 번째 GitLab Pages 배포를 트리거합니다.

실행 중인 파이프라인을 보려면 Build > Pipelines로 이동합니다. 파이프라인이 성공하면 Pages 사이트가 배포되어 접근할 수 있습니다.

배포 중에 생성된 아티팩트를 보려면 해당 job을 열고 오른쪽에서 Download artifacts를 선택합니다.

배포 URL 보기#

파이프라인이 성공적으로 완료된 후 다음 단계를 수행합니다:

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Deploy > Pages를 선택합니다.
  3. Deployments에서 활성 배포 URL을 확인할 수 있습니다.
  4. 배포된 GitLab Pages 사이트로 이동하려면 URL을 선택합니다.
Note

파이프라인이 완료된 후 사이트를 사용할 수 있게 되기까지 몇 분이 걸릴 수 있습니다.

문제 해결#

Get Started with Pages 양식을 사용할 수 없는 경우#

다음에 해당하면 Get Started with Pages 양식을 사용할 수 없습니다:

  • 이전에 GitLab Pages 사이트를 배포한 경우.
  • 양식을 통해 .gitlab-ci.yml을 한 번 이상 커밋한 경우.

이 문제를 해결하려면 다음을 수행합니다:

  • Waiting for the Pages Pipeline to complete 메시지가 표시되면 Start over를 선택하여 양식을 처음부터 다시 시작합니다.
  • 프로젝트에서 이전에 GitLab Pages를 성공적으로 배포한 적이 있다면 .gitlab-ci.yml 파일을 직접 업데이트합니다.

정적 사이트를 위한 GitLab Pages 배포 만들기

GitLab v19.5
Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

GitLab Pages 배포를 만들면 정적 사이트나 프레임워크를 GitLab에서 호스팅되는 웹사이트로 전환할 수 있습니다. Pages UI로 정적 사이트 또는 프레임워크 기반 애플리케이션을 배포할 수 있습니다. 애플리케이션이 public 폴더로 파일을 출력해야 합니다.

GitLab Pages 배포를 만들면 정적 사이트나 프레임워크를 GitLab에서 호스팅되는 웹사이트로 전환할 수 있습니다. 단계별 양식을 통해 GitLab은 다음을 수행합니다:

  • 프로젝트 구성에 맞춘 CI/CD 구성을 생성합니다.
  • GitLab Pages 배포에 맞게 구성된 .gitlab-ci.yml 파일을 만듭니다.
  • 검토할 수 있도록 머지 리퀘스트로 변경 사항을 제출합니다.
  • 머지 리퀘스트가 병합되면 웹사이트를 자동으로 배포합니다.

Pages UI로 정적 사이트 또는 프레임워크 기반 애플리케이션을 배포할 수 있습니다.

사전 요구 사항#

  • 애플리케이션이 public 폴더로 파일을 출력해야 합니다. 빌드 파이프라인 중에 이 폴더를 만든다면 Git에 커밋할 필요가 없습니다.

    [!warning] 이 단계는 중요합니다. 파일이 루트 수준의 public 폴더에 있는지 확인합니다.

  • 다음 중 하나에 해당하는 프로젝트가 있어야 합니다:

    • Eleventy, Astro, Jekyll처럼 정적 사이트 또는 클라이언트 렌더링 단일 페이지 애플리케이션(SPA)을 생성하는 프로젝트.
    • Next.js, Nuxt, SvelteKit처럼 정적 출력으로 구성된 프레임워크를 포함하는 프로젝트.

  • 프로젝트에서 GitLab Pages가 켜져 있어야 합니다. (켜려면 Settings > General로 이동하여 Visibility, project features, permissions를 확장한 다음 Pages 토글을 켭니다.)

Pages 배포 만들기#

설정을 완료하고 GitLab Pages 배포를 생성하려면 다음 단계를 수행합니다:

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 Deploy > Pages를 선택합니다.

    Get Started with Pages 양식이 표시됩니다. 이 양식이 표시되지 않으면 문제 해결을 참고합니다.

  3. Step 1에서 이미지 이름을 입력합니다. Pages로 배포할 사용자 지정 폴더를 설정할 수도 있습니다.

  4. Next를 선택합니다.

  5. Step 2에서 설치 단계를 입력합니다. 프레임워크의 빌드 과정에 제공된 빌드 명령 중 하나가 필요하지 않다면 다음 중 하나를 수행합니다:

    • Next를 선택하여 해당 단계를 건너뜁니다.
    • 그 단계의 기본 골격을 .gitlab-ci.yml 파일에 그대로 포함하려면 :(아무 동작도 하지 않는 bash 명령)를 입력합니다.

  6. Next를 선택합니다.

  7. Step 3에서 애플리케이션을 빌드하는 방법을 나타내는 스크립트를 입력합니다.

  8. Next를 선택합니다.

  9. 선택 사항. 생성된 .gitlab-ci.yml 파일을 필요에 맞게 편집합니다.

  10. Step 4에서 커밋 메시지를 추가하고 Commit을 선택합니다. 이 커밋이 첫 번째 GitLab Pages 배포를 트리거합니다.

실행 중인 파이프라인을 보려면 Build > Pipelines로 이동합니다. 파이프라인이 성공하면 Pages 사이트가 배포되어 접근할 수 있습니다.

배포 중에 생성된 아티팩트를 보려면 해당 job을 열고 오른쪽에서 Download artifacts를 선택합니다.

배포 URL 보기#

파이프라인이 성공적으로 완료된 후 다음 단계를 수행합니다:

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Deploy > Pages를 선택합니다.
  3. Deployments에서 활성 배포 URL을 확인할 수 있습니다.
  4. 배포된 GitLab Pages 사이트로 이동하려면 URL을 선택합니다.
Note

파이프라인이 완료된 후 사이트를 사용할 수 있게 되기까지 몇 분이 걸릴 수 있습니다.

문제 해결#

Get Started with Pages 양식을 사용할 수 없는 경우#

다음에 해당하면 Get Started with Pages 양식을 사용할 수 없습니다:

  • 이전에 GitLab Pages 사이트를 배포한 경우.
  • 양식을 통해 .gitlab-ci.yml을 한 번 이상 커밋한 경우.

이 문제를 해결하려면 다음을 수행합니다:

  • Waiting for the Pages Pipeline to complete 메시지가 표시되면 Start over를 선택하여 양식을 처음부터 다시 시작합니다.
  • 프로젝트에서 이전에 GitLab Pages를 성공적으로 배포한 적이 있다면 .gitlab-ci.yml 파일을 직접 업데이트합니다.