메인 컨텐츠로 이동
Version: 2.0.0-beta.10 🚧

배포

웹 사이트에 게시할 파일을 빌드하기 위해서 아래 명령을 실행합니다.

npm run build

명령을 실행하면 build 디렉터리 아래에 파일이 생성됩니다.

note

도큐사우루스는 여러분의 사이트를 빌드하고 정적 파일을 build 디렉터리 아래에 생성하는 것까지만 책임집니다.

만들어진 정적 파일을 어떻게 호스팅할 것인지는 여러분에게 달려 있습니다.

여러분의 사이트는 베르셀(Vercel), 깃허브 페이지(GitHub Pages), 네트리파이(Netlify), 렌더(Render), 서지(Surge) 같은 파일 호스팅 서비스로 배포할 수도 있습니다...

도큐사우루스 사이트는 정적 렌더링 방식을 사용합니다. 자바스크립트가 없이도 잘 동작합니다.

설정

The following parameters are required in docusaurus.config.js in order for Docusaurus to optimize routing and serve files from the correct location:

옵션명설명
urlURL for your site. For a site deployed at https://my-org.com/my-project/, url is https://my-org.com/.
baseUrlBase URL for your project, with a trailing slash. For a site deployed at https://my-org.com/my-project/, baseUrl is /my-project/.

로컬에서 빌드 테스트하기

실제 배포 작업을 진행하기 전에 로컬에서 빌드 테스트를 진행해야 합니다. Docusaurus provides a docusaurus serve command for that:

npm run serve

By default, this will load your site at http://localhost:3000/.

트레일링 슬래시 설정

도큐사우루스는 URL/링크와 파일명 생성 패턴을 선택할 수 있는 trailingSlash 설정을 지원합니다.

기본값에서도 잘 동작합니다. 하지만 정적 호스팅 서비스 제공 업체에 따라 다른 동작 방식을 가질 수 있습니다. 때문에 같은 사이트를 여러 서비스에 배포하면 다른 결과가 나타날 수도 있습니다. 여러분이 선택한 호스팅 서비스에 따라 설정을 변경해서 사용할 수 있습니다.

tip

호스팅 서비스에서 지원하는 동작 방식과 적절한 trailingSlash 설정을 위해 slorber/trailing-slash-guide 문서를 참조하세요.

웹 서버를 구축하고 직접 호스팅하기

도큐사우루스에서 docusaurus serve 명령을 사용해 직접 호스팅할 준비를 할 수 있습니다. --port 옵션에서 포트를 변경하고 --host 옵션에서 호스트를 변경합니다.

npm run serve -- --build --port 80 --host 0.0.0.0
warning

직접 호스팅하는 것은 정적 호스팅 서비스 제공 업체나 CDN과 비교해서 최선의 선택은 아닙니다.

warning

In the following sections, we will introduce a few common hosting providers and how they should be configured to deploy Docusaurus sites most efficiently. The documentation may not be up-to-date: recent changes in their API may not be reflected on our side. If you see outdated content, PRs are welcome.

For the same concern of up-to-datedness, we have stopped accepting PRs adding new hosting options. You can, however, publish your writeup on a separate site (e.g. your blog, or the provider's official website), and ask us to include a link to your writeup.

깃허브 페이지(GitHub Pages)를 사용해 배포하기

Docusaurus provides an easy way to publish to GitHub Pages, which comes for free with every GitHub repository.

개요

Usually, there are two repositories (at least, two branches) involved in a publishing process: the branch containing the source files, and the branch containing the build output to be served with GitHub Pages. In the following tutorial they will be referred to as "source" and "deployment", respectively.

Each GitHub repository is associated with a GitHub Pages service. If the deployment repository is called my-org/my-project (where my-org is the organization name or username), the deployed site will appear at https://my-org.github.io/my-project/. Specially, if the deployment repository is called my-org/my-org.github.io (the organization GitHub Pages repo), the site will appear at https://my-org.github.io/.

info

깃허브 페이지에 여러분이 가지고 있는 도메인을 연결하기 원한다면 static 디렉터리 안에 CNAME 파일을 만들어줍니다. static 디렉터리 아래 있는 파일은 모두 배포 시 build 디렉터리 아래로 복사됩니다. When using a custom domain, you should be able to move back from baseUrl: '/projectName/' to baseUrl: '/', and also set your url to your custom domain.

좀 더 자세한 내용은 깃허브 페이지 가이드 문서를 참고하세요.

GitHub Pages picks up deploy-ready files (the output from docusaurus build) from the default branch (master / main, usually) or the gh-pages branch, and either from the root or the /docs folder. You can configure that through Settings > Pages in your repository. This branch will be called the "deployment branch".

We provide a docusaurus deploy command that helps you deploy your site from the source branch to the deployment branch in one command: clone, build, and commit.

docusaurus.config.js 파일 설정하기

First, modify your docusaurus.config.js and add the following params:

옵션명설명
organizationNameThe GitHub user or organization that owns the deployment repository.
projectNameThe name of the deployment repository.
deploymentBranchThe name of deployment branch. Defaults to 'gh-pages' for non-organization GitHub Pages repos (projectName not ending in .github.io). Otherwise, this needs to be explicit as a config field or environment variable.

These fields also have their environment variable counterparts, which have a higher priority: ORGANIZATION_NAME, PROJECT_NAME, and DEPLOYMENT_BRANCH.

caution

깃헙 페이지는 도큐사우루스 URL에 트레일링 슬래시를 기본적으로 추가합니다. trailingSlash 설정은 (true 또는 false, undefined는 제외) 값으로 설정하는 것을 권장합니다.

예를 들면 아래와 같이 설정합니다.

docusaurus.config.js
module.exports = {
// ...
url: 'https://endiliey.github.io', // Your website URL
baseUrl: '/',
projectName: 'endiliey.github.io',
organizationName: 'endiliey',
trailingSlash: false,
// ...
};
warning

기본적으로 깃허브 페이지는 지킬을 통해 게시된 파일을 실행합니다. 지킬은 _로 시작하는 모든 파일을 삭제합니다. 때문에 static 디렉터리에 .nojekyll라는 이름을 가진 빈 파일을 추가해 지킬을 비활성화하는 것을 권장합니다.

환경 설정

옵션명설명
USE_SSH깃허브 저장소에 연결 시 기본 HTTPS 대신 SSH를 사용하려면 true로 설정합니다. If the source repo URL is an SSH URL (e.g. [email protected]:facebook/docusaurus.git), USE_SSH is inferred to be true.
GIT_USERThe username for a GitHub account that has push access to the deployment repo. 여러분이 소유자인 저장소라면 사용하고 있는 깃허브 사용자명을 설정합니다. Required if not using SSH, and ignored otherwise.
GIT_PASSPersonal access token of the git user (specified by GIT_USER), to facilitate non-interactive deployment (e.g. continuous deployment)
CURRENT_BRANCHThe source branch. Usually, the branch will be main or master, but it could be any branch except for gh-pages. If nothing is set for this variable, then the current branch from which docusaurus deploy is invoked will be used.

깃허브 엔터프라이즈를 사용하는 경우에도 깃허브와 다르지 않습니다. 환경 변수에 깃허브 엔터프라이즈에서 사용하는 그룹 계정을 설정해주기만 하면 됩니다.

옵션명설명
GITHUB_HOST깃허브 엔터프라이즈 사이트에서 사용하는 도메인 이름을 설정합니다.
GITHUB_PORT깃허브 엔터프라이즈 사이트에서 사용하는 포트를 설정합니다.

배포

이제 아래 명령을 사용해 여러분의 사이트를 깃허브 페이지로 배포합니다.

GIT_USER=<GITHUB_USERNAME> yarn deploy
caution

Beginning in August 2021, GitHub requires every command-line sign-in to use the personal access token instead of the password. When GitHub prompts for your password, enter the PAT instead. See the GitHub documentation for more information. Alternatively, you can use SSH (USE_SSH=true) to login.

깃허브 액션(GitHub Actions)을 사용해 자동으로 배포하기

깃허브 액션은 여러분의 저장소에서 소프트웨어 배포를 자동으로 원하는 형태로 실행할 수 있도록 지원합니다. The workflow examples below assume your website source resides in the main branch of your repository (the source branch is main), under a folder called website/, and your publishing source is configured for the gh-pages branch (the deployment branch is gh-pages). Our goal is that:

  1. When a new pull request is made to main and updates website/, there's an action that ensures the site builds successfully, without actually deploying. This job will be called test-deploy.
  2. When a pull request is merged to the main branch or someone pushes to the main branch directly and website/ is updated, it will be built and deployed to the gh-pages branch. After that, the new built output will be served on the GitHub Pages site. This job will be called deploy. Here are two approaches to deploying your docs with GitHub Actions. Based on the location of your deployment branch (gh-pages), choose the relevant tab below:
  • Source repo and deployment repo are the same repository.
  • The deployment repo is a remote repository, different from the source.

While you can have both jobs defined in the same workflow file, the deploy job will always be listed as skipped in the PR check suite status. That's added noise providing no value to the review process, and as you cannot easily share common snippets, it is better to manage them as separate workflows instead.

We will use a popular third-party deployment action: peaceiris/actions-gh-pages.

GitHub action files

Add these two workflow files:

warning

These files assume you are using yarn. If you use npm, change cache: yarn, yarn install --frozen-lockfile, yarn build to cache: npm, npm ci, npm run build accordingly.

.github/workflows/deploy.yml
name: Deploy to GitHub Pages

on:
push:
branches: [main]
paths: [website/**]

jobs:
deploy:
name: Deploy to GitHub Pages
runs-on: ubuntu-latest
steps:
- uses: actions/[email protected]
- uses: actions/setup-[email protected]
with:
node-version: 14.x
cache: yarn
- name: Build website
working-directory: website
run: |
yarn install --frozen-lockfile
yarn build

# Popular action to deploy to GitHub Pages:
# Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
- name: Deploy to GitHub Pages
uses: peaceiris/actions-gh-[email protected]
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
# Build output to publish to the `gh-pages` branch:
publish_dir: ./website/build
# Assign commit authorship to the official GH-Actions bot for deploys to `gh-pages` branch:
# https://github.com/actions/checkout/issues/13#issuecomment-724415212
# The GH actions bot is used by default if you didn't specify the two fields.
# You can swap them out with your own user credentials.
user_name: github-actions[bot]
user_email: 41898282+github-actions[bot]@users.noreply.github.com
.github/workflows/test-deploy.yml
name: Test deployment

on:
pull_request:
branches: [main]
paths: [website/**]

jobs:
test-deploy:
name: Test deployment
runs-on: ubuntu-latest
steps:
- uses: actions/[email protected]
- uses: actions/setup-[email protected]
with:
node-version: 14.x
cache: yarn
- name: Test build
working-directory: website
run: |
yarn install --frozen-lockfile
yarn build

트래비스 CI(Travis CI)를 사용해 자동으로 배포하기

지속적인 통합(CI) 서비스는 저장소에 새로운 커밋이 발생할때마다 반복적으로 발생하는 작업을 처리하기 위해 사용합니다. 지속적인 통합 환경에서는 단위 테스트, 통합 테스트, 자동 빌드, NPM 배포, 변경된 내용을 웹 사이트에 배포하기 같은 복합적인 작업을 처리할 수 있습니다. 자동으로 웹 사이트 업데이트를 처리하기 위해서는 웹 사이트가 변경됐을때 yarn deploy 스크립트를 호출하기만 하면 됩니다. 지속적인 통합 환경으로 많이 사용하고 있는 트래비스 CI에서 어떻게 도큐사우르스를 배포할 수 있는지 살펴보겠습니다.

  1. https://github.com/settings/tokens에 접속해서 새로운 개인용 접근 토큰을 만듭니다. 토큰을 만들 때 필요한 권한을 가질 수 있도록 repo 범위를 체크해주어야 합니다.
  2. 깃허브 사용자 계정을 사용해 활성화하고자 하는 저장소에 트래비스 CI 앱을 추가합니다.
  3. 트래비스 CI 대시보드를 실행합니다. The URL looks like https://travis-ci.com/USERNAME/REPO, and navigate to the More options > Setting > Environment Variables section of your repository.
  4. 새로 만든 토큰을 사용해 GH_TOKEN라는 이름으로 환경 변수를 만들고 GH_EMAIL(이메일 주소), GH_NAME(깃허브 사용자 이름) 환경 변수도 만들어줍니다.
  5. 아래와 같은 내용으로 저장소 루트에 .travis.yml 파일을 만들어줍니다.
.travis.yml
language: node_js
node_js:
- '14.15.0'
branches:
only:
- main
cache:
yarn: true
script:
- git config --global user.name "${GH_NAME}"
- git config --global user.email "${GH_EMAIL}"
- echo "machine github.com login ${GH_NAME} password ${GH_TOKEN}" > ~/.netrc
- yarn install
- GIT_USER="${GH_NAME}" yarn deploy

이제 main 브랜치에 새로운 커밋이 발생하면 트래비스 CI는 테스트 스위트를 실행하고 모든 테스트가 통과되면 yarn deploy 스크립트가 실행되어 여러분의 웹사이트를 배포하게 됩니다.

Buddy를 사용해 자동으로 배포하기

Buddy는 깃헙 페이지를 포함한 다양한 환경에 여러분의 사이트 배포를 손쉽게 자동화할 수 있는 CI/CD 도구입니다.

아래 단계에 따라 프로젝트의 선택한 브랜치에 대한 변경 사항을 푸시할 때마다 웹 사이트의 새로운 버전을 자동으로 배포하는 파이브 라인을 만듭니다.

  1. https://github.com/settings/tokens에 접속해서 새로운 개인용 접근 토큰을 만듭니다. 토큰을 만들 때 필요한 권한을 가질 수 있도록 repo 범위를 체크해주어야 합니다.
  2. Buddy 계정에 로그인하고 새 프로젝트를 만듭니다.
  3. 깃헙을 깃 호스팅 공급자로 선택하고 웹 사이트 코드가 있는 저장소를 선택합니다.
  4. 왼쪽 탐색 패널을 사용해 Pipelines 보기로 전환합니다.
  5. 새 파이프 라인을 만듭니다. 이름을 정의하고 트리거 모드를 On push로 설정한 다음 파이프 라인 실행을 트리거하는 브랜치를 선택합니다.
  6. Node.js 액션을 추가합니다.
  7. Add these commands in the action's terminal:
GIT_USER=<GH_PERSONAL_ACCESS_TOKEN>
git config --global user.email "<YOUR_GH_EMAIL>"
git config --global user.name "<YOUR_GH_USERNAME>"
yarn deploy

간단하게 파이프 라인을 만든 후 선택한 브랜치에 푸시된 각 새로운 커밋은 yarn deploy 명령을 사용해 웹 사이트를 깃헙 페이지에 배포합니다. 도큐사우루스에 맞춘 CI/CD 파이프 라인 설정에 대한 좀 더 자세한 내용은 가이드 문서를 참고하세요.

애저 파이프라인(Azure Pipeline) 사용하기

  1. 계정이 없다면 먼저 애저 파이프라인에서 계정을 만듭니다.
  2. 그룹 계정(organization)을 만들고 그룹 계정으로 프로젝트를 만듭니다. 그리고 깃허브 저장소를 연결합니다.
  3. https://github.com/settings/tokens에 접속해서 새로운 개인용 접근 토큰을 만들고 repo 범위를 체크해줍니다.
  4. 프로젝트 페이지(https://dev.azure.com/ORG_NAME/REPO_NAME/_build 형식입니다)에서 다음 내용을 참고해서 새로운 파이프라인을 만듭니다. 'edit' 버튼을 클릭해서 새로 만든 토큰을 사용해 GH_TOKEN라는 이름으로 환경 변수를 만들고 GH_EMAIL(이메일 주소), GH_NAME(깃허브 사용자 이름) 환경 변수도 만들어줍니다. 환경 변수는 secret로 설정되어야 합니다. 다른 방법으로는 아래와 같은 내용으로 azure-pipelines.yml 파일을 저장소 루트에 만들어줍니다.
azure-pipelines.yml
trigger:
- main

pool:
vmImage: ubuntu-latest

steps:
- checkout: self
persistCredentials: true

- task: [email protected]
inputs:
versionSpec: 14.x
displayName: Install Node.js

- script: |
git config --global user.name "${GH_NAME}"
git config --global user.email "${GH_EMAIL}"
git checkout -b main
echo "machine github.com login ${GH_NAME} password ${GH_TOKEN}" > ~/.netrc
yarn install
GIT_USER="${GH_NAME}" yarn deploy
env:
GH_NAME: $(GH_NAME)
GH_EMAIL: $(GH_EMAIL)
GH_TOKEN: $(GH_TOKEN)
displayName: Install and build

드론 CI(Drone CI) 사용하기

  1. 프로젝트에서 배포키로 사용할 SSH 키를 새로 만듭니다.
  2. 다른 SSH 키를 덮어쓰지 않도록 주의해서 개인키와 공개키 이름을 설정합니다.
  3. https://github.com/USERNAME/REPO/settings/keys에 접속해서 배포키를 앞에서 만든 공개키 값으로 설정합니다.
  4. 드론 CI 대시보드에 로그인합니다. 연결할 URL은 https://cloud.drone.io/USERNAME/REPO 형식입니다.
  5. 저장소를 선택하고 'activate repository' 버튼을 클릭합니다. 그리고 이름은 git_deploy_private_key, 값은 앞에서 만든 개인키로 지정한 secret를 추가합니다.
  6. 아래와 같은 내용으로 저장소 루트에 .drone.yml 파일을 만들어줍니다.
.drone.yml
kind: pipeline
type: docker
trigger:
event:
- tag
- name: Website
image: node
commands:
- mkdir -p $HOME/.ssh
- ssh-keyscan -t rsa github.com >> $HOME/.ssh/known_hosts
- echo "$GITHUB_PRIVATE_KEY" > "$HOME/.ssh/id_rsa"
- chmod 0600 $HOME/.ssh/id_rsa
- cd website
- yarn install
- yarn deploy
environment:
USE_SSH: true
GITHUB_PRIVATE_KEY:
from_secret: git_deploy_private_key

이제 깃허브에 새로운 태그가 들어오면 여러분의 웹 사이트를 배포하기 위한 드론 CI 동작이 자동으로 시작됩니다.

네트리파이(Netlify)를 사용해 배포하기

여러분의 도큐사우루스 2 사이트를 네트리파이(Netlify)에 배포하려면 먼저 아래와 같은 설정이 필요합니다.

docusaurus.config.js
module.exports = {
url: 'https://docusaurus-2.netlify.app', // Url to your site with no trailing slash
baseUrl: '/', // Base directory of your site relative to your repo
// ...
};

그리고나서 여러분의 사이트를 네트리파이에 만듭니다.

사이트 설정을 위해 다음과 같은 빌드 명령과 디렉터리를 지정해주세요.

  • 빌드 명령: npm run build
  • 빌드 디렉터리: build

사전에 빌드 옵션을 설정하지 않았더라도 사이트를 만든 이후에 "Site settings" -> "Build and deploy" 메뉴에서 설정할 수 있습니다.

위에 설명한 옵션으로 적절하게 설정했다면 여러분의 사이트를 배포할 수 있습니다. 그리고 기본적으로 main으로 설정된 배포 브랜치에 병합되면 자동으로 재배포가 진행됩니다.

caution

일부 도큐사우루스 사이트는 아래와 같이 website 폴더 바깥쪽에 docs 폴더를 가집니다(대부분 도큐사우루스 v1 사이트입니다)

repo           # git root
├── docs # md files
└── website # docusaurus root

website 폴더를 네트리파이 기본 디렉터리로 사용하는 것으로 설정하면 네트리파이는 docs 폴더를 업데이트할 때 빌드 작업을 실행하지 않습니다. 그리고 아래와 같이 사용자 지정 ignore 명령을 설정해주어야 합니다.

website/netlify.toml
[build]
ignore = "git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF . ../docs/"
warning

기본적으로 네트리파이는 트레일링 슬래시를 도큐사우루스 URL에 추가합니다.

URL 소문자 변환, 원하지 않는 리다이렉트, 404 에러를 방지하기 위해 네트리파이에서 Post Processing > Asset Optimization > Pretty Urls 설정을 비활성화 체크해주는 것을 권장합니다.

정말 주의하세요: Disable asset optimization 전역 체크 기능은 잘 동작하지 않습니다. 해당 항목을 체크해도 Pretty URLs 설정이 비활성화되지는 않습니다. 각 항목을 개별적으로 체크해주세요.

네트리파이에서 Pretty Urls 설정을 활성화하고 싶다면 도큐사우루스에서 trailingSlash 설정을 그에 맞게 조정해주어야 합니다.

좀 더 자세한 정보는 slorber/trailing-slash-guide를 참고하세요.

베르셀(Vercel)을 사용해 배포하기

도큐사우루스 프로젝트를 베르셀(Vercel)에 배포하면 성능과 사용 편의성 측면에서 몇 가지 이점이 제공됩니다.

베르셀 깃 통합 기능을 사용해 도큐사우루스 프로젝트를 배포하기 위해서는 깃 저장소에 제대로 업로드되었는지 확인합니다.

베르셀의 가져오기 기능을 이용해 프로젝트를 가져옵니다. 가져오기 시 미리 설정된 관련 옵션을 확인할 수 있습니다. 모든 옵션은 변경할 수 있으며 목록은 베르셀 가이드 문서에서 확인할 수 있습니다.

프로젝트를 가져온 후 브랜치로 보내지는 모든 작업에 대해 미리보기 배포가 만들어집니다. 그리고 제품 브랜치(보통 "main")에 변경이 생기면 제품 배포가 진행됩니다.

렌더(Render)를 사용해 배포하기

렌더(Render)무료 사이트 호스팅 서비스를 제공합니다. SSL, 커스텀 도메인, 글로벌 CDN, 깃 저장소와 연동한 지속적인 자동 배포를 지원합니다. 렌더에서 도큐사우루스 배포하기 가이드를 참고하면 빠르게 시작해볼 수 있습니다.

Qovery를 사용해 배포하기

Qovery는 여러분의 AWS, GCP, Azure, Digital Ocean, Scaleway 같은 여러 계정에서 동작하고 있는 정적 사이트, 백엔드 API, 데이터베이스, 크론잡, 기타 앱을 한 곳에서 관리할 수 있는 완전 관리형 클라우드 플랫폼입니다.

  1. Qovery 계정을 만듭니다. 계정이 없는 경우 Qovery 대시보드에서 계정을 만듭니다.
  2. Create a project.
    • Create project 링크를 클릭하고 프로젝트 이름을 설정합니다.
    • Next 버튼을 클릭합니다.
  3. Create a new environment.
    • Create environment 링크를 클릭하고 이름을 설정합니다(예: staging, production).
  4. Add an application.
    • Create an application 링크를 클릭하고 이름을 설정한 후 도큐사우루스 앱이 위치한 GitHub 또는 GitLab 저장소를 선택합니다.
    • 메인 브랜치 이름과 루트 애플리케이션 경로를 설정합니다.
    • Create 버튼을 클릭합니다. 애플리케이션이 만들어진 후에는
    • 생성한 애플리케이션 Settings을 확인합니다.
    • 포트를 선택합니다.
    • 도큐사우루스 애플리케이션에서 사용하는 포트를 추가합니다.
  5. Deploy All you have to do now is to navigate to your application and click on Deploy.

Deploy the app

이게 다예요! 상태를 확인하면서 앱이 배포될 때까지 기다립니다. To open the application in your browser, click on Action and Open in your application overview.

Hostman을 사용해 배포하기

Hostman은 정적 웹 사이트에 대한 무료 호스팅을 제공합니다. Hostman은 모든 것을 자동화로 지원합니다. 여러분은 저장소를 연결하고 간단한 단계를 따라오기만 하면 됩니다.

  1. Create a service.

    To deploy a Docusaurus static website, click Create in the top-left corner of your Dashboard and choose Front-end app or static website.

  2. Select the project to deploy.

    깃허브, 깃랩, 비트버킷 계정으로 Hostman에 로그인했다면 개인 저장소를 포함해 여러분의 프로젝트가 있는 모든 저장소를 확인할 수 있습니다.

    배포할 프로젝트를 선택합니다. 프로젝트 파일이 있는 디렉터리를 포함해야 합니다(보통 website 또는 my-website 디렉터리입니다).

    To access a different repository, click Connect another repository.

    로그인 시 깃 계정 인증을 거치지 않았다면 필요한 계정에 접근한 후 프로젝트를 선택할 수 있습니다.

  3. Configure the build settings.

    Next, the Website customization window will appear. Choose the Static website option from the list of frameworks.

    The Directory with app points at the directory that will contain the project's files after the build. You can leave it empty if during Step 2 you selected the repository with the contents of the website (or my_website) directory.

    도큐사우루스의 기본 빌드 명령을 실행합니다.

    npm run build

    필요한 경우 빌드 명령을 변경할 수 있습니다. You can enter multiple commands separated by &&.

  4. Deploy.

    Click Deploy to start the build process.

    프로세스가 시작되면 배포 로그를 확인할 수 있습니다. 코드에 문제가 있다면 로그에서 경고나 에러 메시지를 확인하고 문제의 원인을 살펴볼 수 있습니다. Usually, the log contains all the debugging data you'll need.

    When the deployment is complete, you will receive an email notification and also see a log entry. 완료되었습니다 ! 여러분의 프로젝트를 공개할 준비가 끝났습니다.

서지(Surge)를 사용해 배포하기

서지(Surge)는 웹 호스팅 플랫폼입니다. 명령행 도구를 사용해 간단하게 도큐사우루스 프로젝트를 배포할 수 있습니다. 여러분의 프로젝트를 서지에 배포하는 것은 쉽고 무료(커스텀 도메인과 SSL을 포함해)입니다.

다음 단계를 따라가면 서지를 사용한 앱 배포를 쉽게 할 수 있습니다.

  1. 먼저 npm 명령으로 서지를 설치합니다.
    npm install -g surge
  2. 프로젝트 루트 디렉터리에서 사이트의 파일을 빌드하려면 아래 명령을 실행합니다.
    npm run build
  3. 다음 명령어를 프로젝트 루트 디렉토리에서 실행하세요:
    surge build/

서지를 처음 사용한다면 명령행에 계정을 만들라는 메시지가 표시됩니다(처음 한 번만 표시됩니다)

사이트가 build 디렉터리에 게시되면 *.surge.sh 서브도메인이 무작위로 만들어집니다(서브도메인은 수정할 수 있습니다).

가지고 있는 도메인 사용하기

가지고 있는 도메인이 있다면 서지를 사용해 배포 시 명령에 도메인을 추가할 수 있습니다.

surge build/ yourdomain.com

여러분의 사이트는 선택에 따라 무료로 제공되는 subdomain.surge.sh 또는 yourdomain.com에서 운영할 수 있습니다.

CNAME 파일 설정하기

다음 명령을 사용해 도메인을 CNAME 파일에 설정할 수 있습니다.

echo subdomain.surge.sh > CNAME

surge 명령을 사용해 이후 변경 사항 발생 시 배포를 진행할 수 있습니다.

퀀트CDN(QuantCDN)을 사용해 배포하기

  1. 퀀트(Quant) CLI를 설치합니다.
  2. 퀀트CDN 계정을 생성합니다.
  3. quant init 명령으로 프로젝트를 초기화하고 여러분의 자격 정보를 설정합니다.
    quant init
  4. Deploy your site.
    quant deploy

퀀트CDN을 사용한 배포 예제와 사용 사례는 가이드 문서블로그를 참고하세요.