GitHub 리포지토리에 대한 Amplify 액세스 설정

Amplify는 이제 GitHub 앱 기능을 사용하여 GitHub 리포지토리에 대한 Amplify의 읽기 전용 액세스를 승인합니다. Amplify GitHub 앱을 사용하면 권한이 더욱 세밀하게 조정되므로 지정한 리포지토리에만 Amplify에 액세스 권한을 부여할 수 있습니다. GitHub 앱에 대해 자세히 알아보려면 GitHub 웹 사이트의 GitHub 앱 정보를 참조하세요.

GitHub 리포지토리에 저장된 새 앱을 연결하면 Amplify는 기본적으로 GitHub 앱을 사용하여 리포지토리에 액세스합니다. 하지만 이전에 GitHub 리포지토리에서 연결한 기존 Amplify 앱은 액세스에 OAuth를 사용합니다. CI/CD는 이러한 앱에서 계속 작동하지만 새로운 Amplify GitHub 앱을 사용하도록 마이그레이션하는 것이 좋습니다.

Amplify 콘솔을 사용하여 새 앱을 배포하거나 기존 앱을 마이그레이션하면 Amplify GitHub 앱의 설치 위치로 자동 안내됩니다. 앱의 설치 랜딩 페이지에 수동으로 액세스하려면 웹 브라우저를 열고 리전별로 앱을 탐색하세요. 형식 https://github.com/apps/aws-amplify-REGION을(를) 사용하여 리전을 Amplify 앱을 배포할 리전으로 대체하세요. 예를 들어, 미국 서부(오레곤)리전에 Amplify GitHub 앱을 설치하려면 https://github.com/apps/aws-amplify-us-west-2으로 이동하세요.

새 배포를 위한 Amplify GitHub 앱 설치 및 권한 부여

GitHub 리포지토리의 기존 코드를 사용하여 Amplify에 새 앱을 배포하는 경우, 다음 지침에 따라 GitHub 앱을 설치하고 승인하세요.

Amplify GitHub 앱을 설치하고 승인하려면

1. AWS Management Console에 로그인하고 Amplify 콘솔을 엽니다.

2. 모든 앱 페이지에서 새 앱을 선택한 다음 웹 앱 호스팅을 선택합니다.

3. Amplify Hosting 시작하기 페이지에서 GitHub를 선택한 다음 계속을 선택합니다.

4. GitHub 리포지토리를 처음 연결하는 경우, GitHub.com의 브라우저에 GitHub 계정에서 AWS Amplify을(를) 승인할 수 있는 권한을 요청하는 새 페이지가 열립니다. 승인을 선택합니다.

5. 다음으로 GitHub 계정에 Amplify GitHub 앱을 설치해야 합니다. GitHub 계정에 AWS Amplify의 설치 및 승인을 요청하는 페이지가 GitHub.com에서 열립니다.

6. Amplify GitHub 앱을 설치할 GitHub 계정을 선택합니다.

7. 다음 중 하나를 수행하세요.

   • 모든 리포지토리에 설치를 적용하려면 모든 리포지토리를 선택합니다.

   • 선택한 특정 리포지토리로 설치를 제한하려면 리포지토리만 선택을 선택합니다. 선택한 리포지토리에 마이그레이션하려는 앱의 리포지토리를 포함해야 합니다.

8. 설치 및 승인을 선택합니다.

9. Amplify 콘솔에서 앱의 리포지토리 분기 추가 페이지로 리디렉션됩니다.

10. 최근 업데이트된 리포지토리 목록에서 연결할 리포지토리 이름을 선택합니다.

11. 브랜치 목록에서 연결할 리포지토리 브랜치의 이름을 선택합니다.

12. 다음을 선택합니다.

13. 보안 설정 구성 페이지에서 다음을 선택합니다.

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

기존 OAuth 앱을 Amplify GitHub 앱으로 마이그레이션하기

이전에 GitHub 리포지토리에서 연결한 기존 Amplify 앱은 리포지토리 액세스에 OAuth를 사용합니다. Amplify GitHub 앱을 사용하려면 이러한 앱을 마이그레이션하는 것이 좋습니다.

다음 지침에 따라 앱을 마이그레이션하고 GitHub 계정에서 해당 OAuth 웹후크를 삭제하세요. 참고로 마이그레이션 절차는 Amplify GitHub 앱이 이미 설치되어 있는지 여부에 따라 달라집니다. 첫 번째 앱을 마이그레이션하고 GitHub 앱을 설치 및 승인한 후에는 후속 앱 마이그레이션을 위해 리포지토리 권한만 업데이트하면 됩니다.

앱을 OAuth에서 GitHub 앱으로 마이그레이션하려면

1. AWS Management Console에 로그인하고 Amplify 콘솔을 엽니다.

2. 마이그레이션할 앱을 선택합니다.

3. 앱의 정보 페이지에서 파란색 GitHub 앱으로 마이그레이션 메시지를 찾아 마이그레이션 시작을 선택합니다.

4. GitHub 앱 설치 및 승인 페이지에서 GitHub 앱 구성을 선택합니다.

5. GitHub.com의 브라우저에 GitHub 계정에서 AWS Amplify를 승인할 수 있는 권한을 요청하는 새 페이지가 열립니다. Authorize를 선택합니다.

6. Amplify GitHub 앱을 설치할 GitHub 계정을 선택합니다.

7. 다음 중 하나를 수행하세요.

   • 모든 리포지토리에 설치를 적용하려면 모든 리포지토리를 선택합니다.

   • 선택한 특정 리포지토리로 설치를 제한하려면 리포지토리만 선택을 선택합니다. 선택한 리포지토리에 마이그레이션하려는 앱의 리포지토리를 포함해야 합니다.

8. 설치 및 승인을 선택합니다.

9. Amplify 콘솔의 앱에 대한 GitHub 앱 설치 및 승인 페이지로 리디렉션됩니다. GitHub 인증에 성공하면 성공 메시지가 표시됩니다. 다음을 선택합니다.

10. 설치 완료 페이지에서 설치 완료를 선택합니다. 이 단계는 기존 웹후크를 삭제하고, 새 웹후크를 만들고, 마이그레이션을 완료합니다.

AWS CloudFormation, CLI 및 SDK 배포를 위한 Amplify GitHub 앱 설정

이전에 GitHub 리포지토리에서 연결한 기존 Amplify 앱은 리포지토리 액세스에 OAuth를 사용합니다. 여기에는 Amplify 명령줄 인터페이스(CLI), AWS CloudFormation, 또는 SDK를 사용하여 배포한 앱이 포함될 수 있습니다. 새 Amplify GitHub 앱을 사용하려면 이러한 앱을 마이그레이션하는 것이 좋습니다. 마이그레이션은 Amplify 콘솔의 AWS Management Console에서 수행해야 합니다. 지침은 기존 OAuth 앱을 Amplify GitHub 앱으로 마이그레이션하기 단원을 참조하세요.

AWS CloudFormation, Amplify CLI, SDK를 사용하여 리포지토리 액세스를 위해 GitHub 앱을 사용하는 새로운 Amplify 앱을 배포할 수 있습니다. 이 프로세스를 진행하려면 먼저 GitHub 계정에 Amplify GitHub 앱을 설치해야 합니다. 다음으로 GitHub 계정에서 개인용 액세스 토큰을 생성해야 합니다. 마지막으로 앱을 배포하고 개인용 액세스 토큰을 지정합니다.

계정에 Amplify GitHub 앱을 설치하세요.

1. 웹 브라우저를 열고 앱을 배포할 AWS 리전의 Amplify GitHub 앱 설치 위치로 이동합니다.

   리전을 사용자가 직접 입력한 것으로 대체하는 형식 https://github.com/apps/aws-amplify-REGION/installations/new을(를) 사용하세요. 예를 들어 미국 서부(오레곤)리전에 앱을 설치하는 경우, https://github.com/apps/aws-amplify-us-west-2/installations/new을(를) 지정합니다.

2. Amplify GitHub 앱을 설치할 GitHub 계정을 선택합니다.

3. 다음 중 하나를 수행하세요.

   • 모든 리포지토리에 설치를 적용하려면 모든 리포지토리를 선택합니다.

   • 선택한 특정 리포지토리로 설치를 제한하려면 리포지토리만 선택을 선택합니다. 선택한 리포지토리에 마이그레이션하려는 앱의 리포지토리를 포함해야 합니다.

4. 설치를 선택합니다.

GitHub 계정에서 개인용 액세스 토큰 생성

1. GitHub 계정에 가입합니다.

2. 오른쪽 상단에서 프로필 사진을 찾아 메뉴에서 설정을 선택합니다.

3. 왼쪽 탐색 메뉴에서 개발자 설정을 선택합니다.

4. GitHub 앱 페이지의 왼쪽 탐색 메뉴에서 개인용 액세스 토큰을 선택합니다.

5. 개인용 액세스 토큰 페이지에서 새 토큰 생성을 선택합니다.

6. 새 개인용 액세스 토큰 페이지에서 노트에 토큰을 설명하는 이름을 입력합니다.

7. 범위 선택 섹션에서 admin:repo_hook을 선택합니다.

8. 토큰 생성을 선택합니다.

9. 개인용 액세스 토큰을 복사하고 저장합니다. CLI, AWS CloudFormation 또는 SDK를 사용하여 Amplify 앱을 배포할 때 이를 제공해야 합니다.

Amplify GitHub 앱을 GitHub 계정에 설치하고 개인용 액세스 토큰을 생성한 후에는 Amplify CLI, AWS CloudFormation 또는 SDK를 사용하여 새 앱을 배포할 수 있습니다. accessToken 필드를 사용하여 이전 절차에서 생성한 개인용 액세스 토큰을 지정합니다. 자세한 내용은 Amplify API 참조의 CreateApp 및 AWS CloudFormation 사용 설명서의 AWS::Amplify::앱을 참조하세요.

다음 CLI 명령은 리포지토리 액세스를 위해 GitHub 앱을 사용하는 새로운 Amplify 앱을 배포합니다. myapp-using-Githubapp, https://Github.com/Myaccount/react-app, MY_TOKEN을 사용자 고유의 정보로 바꾸세요.

aws amplify create-app --name myapp-using-githubapp --repository https://github.com/Myaccount/react-app --access-token MY_TOKEN
   
  

Amplify GitHub 앱을 사용하여 웹 미리 보기 설정하기

웹 미리보기는 GitHub 리포지토리에 대한 모든 풀 요청(PR)을 고유한 미리 보기 URL에 배포합니다. 프리뷰는 이제 Amplify GitHub 앱을 사용하여 GitHub 리포지토리에 액세스할 수 있습니다. 웹 미리 보기용 GitHub 앱 설치 및 권한 부여에 대한 지침은 웹 미리 보기를 활성화합니다. 단원을 참조하세요.