Astro 사이트를 GitLab Pages에 배포하세요
GitLab Pages를 사용하여 GitLab 프로젝트, 그룹 또는 사용자 계정을 위한 Astro 사이트를 호스팅할 수 있습니다.
공식 GitLab Pages Astro 예시 프로젝트를 확인해 보세요!
배포 방법
섹션 제목: 배포 방법-
astro.config.mjs
파일에서 올바른site
를 설정하세요. -
public/
디렉터리의 이름을static
으로 바꿉니다. -
astro.config.mjs
파일에서outDir: public
을 설정합니다. 이 설정은 Astro가 공개된 파일을 위해 GitLab Pages에 요구하는public
폴더에 정적 빌드 출력을 저장하도록 지시합니다.Astro 프로젝트에서 정적 파일의 소스로
public/
디렉터리를 사용하고 있었다면 이름을 바꾸고publicDir
값으로astro.config.mjs
의 새 폴더 이름을 사용합니다.예를 들어
public/
디렉터리의 이름이static/
으로 변경된 경우 올바른astro.config.mjs
설정은 다음과 같습니다.import { defineConfig } from 'astro/config';export default defineConfig({site: 'https://<user>.gitlab.io',base: '/<project-name>',outDir: 'public',publicDir: 'static',}); -
아래 내용을 포함하여 프로젝트 루트에
.gitlab-ci.yml
파일을 생성합니다. 콘텐츠가 변경될 때마다 사이트가 빌드되고 배포됩니다.pages:# 앱을 빌드하는 데 사용될 Docker 이미지image: node:ltsbefore_script:- npm ciscript:# 여기에서 앱 빌드와 관련된 단계를 지정하세요.- npm run buildartifacts:paths:# 게시하기 위해 빌드된 파일이 포함된 폴더입니다.# 이것을 "public"라고 불러야 합니다.- publiconly:# 아래 브랜치에 푸시가 있는 경우에만 새 빌드를 트리거하고 배포합니다.- main