GitLab Pages public 폴더

가장 일반적인 정적 사이트 생성기의 빌드 출력 폴더를 구성하는 방법을 알아봅니다.

.gitlab-ci.yml 에서 게시 폴더를 구성할 수 있습니다. 더 이상 프레임워크 구성을 변경할 필요가 없습니다. 자세한 내용은 Pages로 배포할 사용자 정의 폴더 설정 을 참고합니다. 다음 프레임워크에서 public 폴더를 구성하려면 아래 안내를 따릅니다. Eleventy # Eleventy에서는 다음 중 하나를 수행합니다. Eleventy 빌드 명령에 --output=public 플래그를 추가합니다. 예시는 다음과 같습니다. npx @11ty/eleventy --input=path/to/sourcefiles --output=public .eleventy.js 파일에 다음을 추가합니다. // .eleventy.js module . exports = function ( eleventyConfig ) { return { dir : { output : "public" } } }; Astro # Astro는 기본적으로 정적 자산을 저장하는 데 public 폴더를 사용합니다. GitLab Pages에서는 먼저 해당 폴더의 이름을 충돌하지 않는 다른 이름으로 바꿉니다. 프로젝트 디렉터리에서 다음을 실행합니다. mv public static 이름을 바꾼 폴더에 맞게 Astro를 구성하려면 astro.config.mjs 에 다음을 추가합니다. // astro.config.mjs import { defineConfig } from 'astro/config' ; export default defineConfig ({ // GitLab Pages requires exposed files to be located in a folder called "public". // This instructs Astro to put the static build output in a folder of that name. outDir : 'public' , // The folder name Astro uses for static files (`public`) is already reserved // for the build output. This uses a folder called `static` instead. publicDir : 'static' , }); SvelteKit # Note GitLab Pages는 정적 사이트만 지원합니다. SvelteKit에서는 adapter-static 을 사용할 수 있습니다. adapter-static 을 사용할 때는 svelte.config.js 에 다음을 추가합니다. // svelte.config.js import adapter from '@sveltejs/adapter-static' ; export default { kit : { adapter : adapter ({ pages : 'public' }) } }; Next.js # Note GitLab Pages는 정적 사이트만 지원합니다. Next.js에서는 Next의 정적 HTML 내보내기 기능 을 사용할 수 있습니다. Next.js 13 릴리스로 Next.js의 동작