기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amplify Hosting에 Astro.js 앱 배포
<a name="get-started-astro"></a>

Astro.js 애플리케이션을 Amplify Hosting에 배포하려면 다음 지침을 따릅니다. 기존 애플리케이션을 사용하거나 Astro가 제공하는 공식 예제 중 하나를 사용하여 스타터 애플리케이션을 생성할 수 있습니다. 스타터 애플리케이션을 생성하려면 *Astro 설명서*의 [테마 또는 스타터 템플릿 사용](https://docs.astro.build/en/install-and-setup/#use-a-theme-or-starter-template)을 참조하세요.

SSR로 Astro 사이트를 Amplify Hosting에 배포하려면 애플리케이션에 어댑터를 추가해야 합니다. 당사는 Amplify 소유의 Astro 프레임워크용 어댑터를 유지 관리하지 않습니다. 이 자습서에서는 커뮤니티의 구성원이 생성한 `astro-aws-amplify` 어댑터를 사용합니다. 이 어댑터는 GitHub 웹 사이트의 [github.com/alexnguyennz/astro-aws-amplify](https://github.com/alexnguyennz/astro-aws-amplify) 사용할 수 있습니다.이 어댑터는 유지 관리하지 AWS 않습니다.

**Amplify Hosting에 Astro 앱을 배포하려면**

1. 로컬 컴퓨터에서 배포할 Astro 애플리케이션으로 이동합니다.

1. 어댑터를 설치하려면 터미널 창을 열고 다음 명령을 실행합니다. 이 예제에서는 [github.com/alexnguyennz/astro-aws-amplify](https://github.com/alexnguyennz/astro-aws-amplify)에서 사용할 수 있는 커뮤니티 어댑터를 사용합니다. {{astro-aws-amplify}}를 사용 중인 어댑터 이름으로 바꿀 수 있습니다.

   ```
   npm install {{astro-aws-amplify}}
   ```

1. Astro 앱의 프로젝트 폴더에서 `astro.config.mjs` 파일을 엽니다. 이 파일을 업데이트하여 어댑터를 추가합니다. 파일이 다음과 같아야 합니다.

   ```
   import { defineConfig } from 'astro/config';
   import mdx from '@astrojs/mdx';
   {{import awsAmplify from 'astro-aws-amplify';}}
    
   import sitemap from '@astrojs/sitemap';
    
   // https://astro.build/config
   export default defineConfig({
     site: 'https://example.com',
     integrations: [mdx(), sitemap()],
     adapter: {{awsAmplify()}},
     output: 'server',
   });
   ```

1. 변경 사항을 커밋하고 프로젝트를 Git 리포지토리로 푸시합니다.

   이제 Astro 앱을 Amplify에 배포할 준비가 되었습니다.

1. 에 로그인 AWS Management Console 하고 [Amplify 콘솔](https://console.aws.amazon.com/amplify/)을 엽니다.

1. **모든 앱** 페이지에서 **새 앱 생성**을 선택합니다.

1. **Amplify로 빌드 시작** 페이지에서 Git 리포지토리 공급자를 선택하고 **다음**을 선택합니다.

1. **리포지토리 브랜치 추가** 페이지에서 다음을 수행합니다.

   1. 연결할 리포지토리의 이름을 선택합니다.

   1. 연결할 리포지토리 브랜치의 이름을 선택합니다.

   1. **다음**을 선택합니다.

1. **앱 설정** 페이지에서 **빌드 설정** 섹션을 찾습니다. **빌드 출력 디렉터리**에 **.amplify-hosting**을 입력합니다.

1. 빌드 사양에서 앱의 프론트엔드 빌드 명령도 업데이트해야 합니다. 빌드 사양을 열려면 **YML 파일 편집**을 선택합니다.

1. `amplify.yml` 파일에서 프론트엔드 빌드 명령 섹션을 찾습니다. **mv node\_modules ./.amplify-hosting/compute/default**를 입력합니다.

   빌드 설정 파일이 다음과 같아야 합니다.

   ```
   version: 1
   frontend:
       phases:
           preBuild:
               commands:
                   - 'npm ci --cache .npm --prefer-offline'
           build:
               commands:
                   - 'npm run build'
                   - 'mv node_modules ./.amplify-hosting/compute/default'
       artifacts:
           baseDirectory: .amplify-hosting
           files:
               - '**/*'
       cache:
           paths:
               - '.npm/**/*'
   ```

1. **저장**을 선택합니다.

1. Amplify가 Amazon CloudWatch Logs에 앱 로그를 전달할 수 있도록 하려면 콘솔에서 명시적으로 활성화해야 합니다. **고급 설정** 섹션을 열고 **서버 측 렌더링(SSR) 배포** 섹션에서 **SSR 앱 로그 활성화**를 선택합니다.

1. **다음**을 선택합니다.

1. **검토** 페이지에서 **저장 및 배포**를 선택합니다.