InfoGrab Docs

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

요약

GitLab에서 호스팅되는 웹사이트로 정적 사이트 또는 프레임워크를 변환하기 위한 GitLab Pages 배포를 만듭니다. 이 가이드는 Pages UI를 사용하여 정적 사이트 또는 프레임워크 기반 애플리케이션을 배포하는 방법을 설명합니다.

GitLab에서 호스팅되는 웹사이트로 정적 사이트 또는 프레임워크를 변환하기 위한 GitLab Pages 배포를 만듭니다. 단계별 양식을 통해 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 배포 만들기

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

GitLab에서 호스팅되는 웹사이트로 정적 사이트 또는 프레임워크를 변환하기 위한 GitLab Pages 배포를 만듭니다. 이 가이드는 Pages UI를 사용하여 정적 사이트 또는 프레임워크 기반 애플리케이션을 배포하는 방법을 설명합니다.

GitLab에서 호스팅되는 웹사이트로 정적 사이트 또는 프레임워크를 변환하기 위한 GitLab Pages 배포를 만듭니다. 단계별 양식을 통해 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 파일을 수동으로 업데이트합니다.