> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ko/docs/sample-projects/nuxt-on-edgegap.md).

# NuxtJS

Nuxt 웹 애플리케이션을 Edgegap에 배포하고, 글로벌 엣지 네트워크를 통해 사용자에게 가까운 곳에서 서비스를 제공하세요.

### 시작하기

Edgegap은 필요할 때 어디서든 서버리스 웹 애플리케이션을 배포할 수 있는 매우 직관적인 플랫폼을 제공합니다. 이 튜토리얼에서는 Nuxt 앱을 배포하는 단계를 살펴보겠습니다. 다른 것을 확인하기 전에 yarn 또는 npm이나 npx 같은 다른 패키지 관리 소프트웨어가 있는지 확인하세요. 이 튜토리얼에서는 yarn을 사용하겠습니다. 애플리케이션 디렉터리에서 실행 중이어야 하며, 시작할 때는 비어 있는 폴더일 수도 있습니다.

폴더가 있는 위치에서 터미널을 열고 다음 명령을 실행하세요:

{% code collapsedlinecount="10" %}

```
C:\Users\JohnDoe\Documents\demo-nuxt-edgegap> yarn
```

{% endcode %}

모든 종속성이 설치되면, 다음 명령을 실행해 제대로 설치되었는지 확인하세요:

{% code collapsedlinecount="10" %}

```
C:\Users\JohnDoe\Documents\demo-nuxt-edgegap> yarn dev
```

{% endcode %}

모든 것이 순조롭게 진행되었다면 yarn dev는 설치된 yarn의 버전을 반환해야 합니다. 이제 이 부분은 끝났으니, 이 튜토리얼을 성공적으로 완료하는 데 필요한 나머지 요구 사항을 살펴보겠습니다.

### 요구 사항

### 애플리케이션을 컨테이너화하기

대부분의 애플리케이션을 컨테이너화하는 것은 간단합니다. Dockerfile을 만들고, 그 파일을 Docker에서 실행하여 이미지를 생성하면 됩니다. Visual Studio Code는 기본적으로 생성하는 새 파일마다 확장자를 붙이지 않기 때문에 Dockerfile을 만들기에 좋은 플랫폼입니다. 바로 그 점이 우리가 필요로 하는 것입니다. 새 파일을 만들고 이름을 Dockerfile로 지정하기만 하세요. 옆에 작은 docker 로고가 나타나는 것을 볼 수 있습니다.

이제 이 스크립트를 복사해 붙여넣으면 주요 종속성을 가져올 수 있습니다. 참고로 이 작업은 1GB가 조금 넘는 크기의 이미지를 생성합니다. 이 튜토리얼의 목적상 이는 괜찮습니다. 하지만 프로덕션 환경의 애플리케이션이라면 최적화해야 합니다:

{% code collapsedlinecount="10" %}

```dockerfile
FROM node:lts as builder

WORKDIR /app

COPY . .

RUN yarn install \
  --prefer-offline \
  --frozen-lockfile \
  --non-interactive \
  --production=false

RUN yarn build

RUN rm -rf node_modules && \
  NODE_ENV=production yarn install \
  --prefer-offline \
  --pure-lockfile \
  --non-interactive \
  --production=true

FROM node:lts

WORKDIR /app

COPY --from=builder /app  .

ENV HOST 0.0.0.0
EXPOSE 80

CMD [ "yarn", "start" ]
```

{% endcode %}

Dockerfile을 저장한 후에는 이미지를 만들 차례입니다. 다음 명령어를 실행하면 쉽게 만들 수 있습니다:

{% hint style="warning" %}
ARM CPU(Mac M1, M2 등) 사용자는 [전용 페이지](broken://pages/9952b3bfe4b66b002e4c6c5b90d6457959c6f1ca).
{% endhint %}

{% code collapsedlinecount="10" %}

```sh
docker build . -t registry.edgegap.com/<YOUR_REPO>/demo-nuxt-edgegap:<YOUR_VERSION_NUMBER>
```

{% endcode %}

의미적 버전 규칙에 따라 버전 번호를 붙이는 것이 좋지만, 첫 배포 후 Edgegap에서 빌드를 업데이트할 계획이 없다면 버전 번호를 아예 생략해도 됩니다.

하지만 그 전에 새로 만든 docker 이미지를 원하는 이미지 저장소에 푸시해야 합니다. 기본 Docker 저장소를 사용했을 때는 반드시 얻을 수 없는 여러 보안상의 이점을 제공하는 Harbor의 비공개 저장소를 제공한다는 점을 기억하세요.

하지만 그 전에 새로 만든 docker 이미지를 원하는 이미지 저장소에 푸시해야 합니다. 기본 Docker 저장소를 사용했을 때는 반드시 얻을 수 없는 여러 보안상의 이점을 제공하는 Edgegap Registry의 비공개 저장소를 제공한다는 점을 기억하세요.

이미지를 저장소에 푸시하려면 먼저 다음 명령을 사용해 자격 증명으로 로그인해야 합니다:

{% tabs %}
{% tab title="Bash (리눅스)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (윈도우)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

이제 남은 것은 다음과 같이 이미지를 푸시하는 것입니다:

{% code collapsedlinecount="10" %}

```sh
docker push registry.edgegap.com/<YOUR_REPO>/demo-nuxt-edgegap:<YOUR_VERSION_NUMBER>
```

{% endcode %}

좋습니다! 이제 Edgegap 플랫폼에 Nuxt 앱을 배포하기까지 단 한 걸음만 남았습니다.

### Edgegap에 애플리케이션 배포하기

Edgegap에서 애플리케이션을 배포하는 방법은 두 가지가 있습니다. 두 방법 모두 저희 계정이 필요하며, 여기 있는 링크를 클릭하면 무료로 만들 수 있습니다. 먼저 웹사이트를 통해 컨테이너화된 애플리케이션을 배포하는 방법을 살펴보겠습니다.

#### Edgegap 대시보드를 통해 애플리케이션 배포하기:

다음 웹 주소로 이동해 자격 증명을 입력해야 합니다. 그렇게 하면 자동으로 대시보드로 리디렉션됩니다. 계정을 막 만든 경우에는 바로 첫 번째 애플리케이션을 실행할 수 있는 옵션이 보일 것입니다. 그렇지 않다면 화면 왼쪽 메뉴에서 “Applications and games” 탭으로 이동하세요. 오른쪽 모서리에 새 애플리케이션을 만들 수 있는 옵션이 보일 것입니다:

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-fc4b2486acb434863c2a6fd0e3772e02bfd2e214%2Fcreate-app-nuxt-js.png?alt=media" alt=""><figcaption></figcaption></figure>

클릭하면 다음 양식이 나타납니다:

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-488e9bf3f56918ab3e01c15c9364a8fe321a40b5%2Fapp-form-nuxt-js.png?alt=media" alt=""><figcaption></figcaption></figure>

필수 입력란을 모두 채워야 하며, 입력을 마치면 기본값에서 수정해야 할 몇 가지가 있습니다:

* 포트 번호: 이 애플리케이션은 3000 포트를 열어야 하므로, 생성 양식의 “ports” 섹션에 추가하세요.
* 최대 배포 시간: 앞서 이 튜토리얼에서 언급했듯이, 우리의 NuxtJS 이미지는 크기가 약 1GB입니다. Edgegap에 이렇게 큰 이미지를 배포하려면 최대 배포 시간을 약 300초로 늘려야 합니다.

적절한 정보로 양식 작성을 모두 마친 후에는 제출만 하면 배포할 준비가 됩니다. 지역과 에뮬레이션하려는 플레이어 수만 선택하면 됩니다.

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-3f94772bc292c12029b2fcf24a8e4f22df406d08%2Fnuxt-js-app-launch-1.png?alt=media" alt=""><figcaption></figcaption></figure>

선택을 확인하면 곧 애플리케이션이 온라인 상태가 됩니다. 배포되면 다음과 같이 보일 것입니다. 이 이미지에서 원으로 표시한 아이콘을 클릭하면 직접 접근할 수 있습니다.

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-7963d541fcb7a40b3733247854e0fe3e346475b9%2Fnuxt-js-app-launch-2.png?alt=media" alt=""><figcaption></figcaption></figure>

그러면 새 탭이 열리고, 그곳에서 Nuxt 애플리케이션의 기본 랜딩 페이지를 볼 수 있습니다.

#### Edgegap API를 통한 애플리케이션 배포

웹 대시보드가 애플리케이션을 배포하는 가장 사용자 친화적인 방법이지만, 매우 간단한 API 요청으로도 배포할 수 있습니다. 이를 위해 postman을 사용할 수 있습니다. 대시보드에서 방문하여 [API 토큰을 생성](broken://pages/be4ea0f5e04ae245b84d92a9d4ea4ba90751d99f) 프로필의 옵션을 통해서입니다. API 토큰을 만드는 간단한 가이드는 다음과 같습니다.

API 토큰을 확보한 후에는 애플리케이션 이름, 버전, IP 주소, 배포를 수행할 지역, 그리고 물론 인가 매개변수의 일부로 토큰을 포함한 배포 요청을 작성하기만 하면 됩니다. 전체 요청이 어떤 모습인지 여기 문서에서 확인할 수 있습니다.

요청을 보내면 명령줄이나 Postman에서 다음과 같은 응답을 보게 될 것입니다:

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-4963dbbc9a5be5f79c9e449038b40eb250489bba%2Fnuxt-js-app-launch-api.png?alt=media" alt=""><figcaption></figcaption></figure>

CLI를 통해 애플리케이션을 배포하기 위해 해야 할 일은 이것이 전부입니다. 앱이 배포되었는지 확인하려면 대시보드로 다시 이동해 “Active deployments” 탭을 클릭하여 활성 배포가 실행 중인 것을 확인하면 됩니다.
