자습서: AWS CodeStar에 Alexa Skill 프로젝트 생성

AWS CodeStar는 AWS에서 애플리케이션을 신속하게 개발, 구축 및 배포하는 데 필요한 도구를 제공하는 AWS의 클라우드 기반 개발 서비스입니다. AWS CodeStar에서는 몇 분 만에 전체 지속적 전달 도구 체인을 구성할 수 있으므로 코드 릴리스를 더욱 빠르게 시작할 수 있습니다. AWS CodeStar의 Alexa 스킬 프로젝트 템플릿을 사용하면 단 몇 번의 클릭만으로 AWS 계정에서 간단한 Hello World Alexa 스킬을 생성할 수 있습니다. 템플릿은 또한 스킬 개발을 위해 지속적 통합(CI) 워크플로를 시작하는 기본 배포 파이프라인을 생성합니다.

AWS CodeStar에서 Alexa 스킬을 생성할 때의 주요 이점은 AWS에서 스킬 개발을 시작하고 Amazon 개발자 계정을 프로젝트에 연결하여 AWS에서 직접 개발 단계에 스킬을 배포할 수 있다는 것입니다. 또한 프로젝트의 모든 소스 코드가 있는 리포지토리로 배포(CI) 파이프라인을 사용할 준비가 된 것입니다. 선호하는 IDE로 이 리포지토리를 구성하여 익숙한 도구로 스킬을 생성할 수 있습니다.

필수 조건

• https://developer.amazon.com로 이동하여 Amazon 개발자 계정을 생성하십시오. 가입은 무료입니다. 이 계정은 Alexa skill을 소유합니다.

• AWS 계정이 없는 경우 다음 절차에 따라 하나를 생성하십시오.

  AWS에 가입하려면

  1. https://aws.amazon.com/을 연 다음 AWS 계정 생성을 선택합니다.

     참고

     전에 AWS 계정 루트 사용자 자격 증명을 사용하여 AWS Management Console 에 로그인한 적이 있는 경우 Sign in to a different account(다른 계정으로 로그인)를 선택합니다. 이전에 IAM 자격 증명을 사용하여 콘솔에 로그인한 적이 있는 경우 Sign-in using AWS 계정 루트 사용자 credentials(루트 계정 자격 증명으로 로그인)를 선택합니다. 그런 다음 Create a new AWS account(새 AWS 계정 생성)을 선택합니다.

  2. 온라인 지시 사항을 따릅니다.

중요

Alexa 스킬 프로젝트를 생성한 후에는 프로젝트 리포지토리에서만 모든 수정 작업을 수행합니다. ASK CLI 또는 ASK 개발자 콘솔과 같은 다른 Alexa Skill 키트 도구를 사용하여 이 스킬을 직접 편집하지 않는 것이 좋습니다. 이러한 도구는 프로젝트 리포지토리와 통합되지 않습니다. 이를 사용하면 스킬과 리포지토리 코드가 동기화되지 않습니다.

1단계: 프로젝트 생성 및 Amazon 개발자 계정 연결

이 자습서에서는 AWS Lambda에서 실행되는 Node.js를 사용하여 스킬을 생성합니다. 스킬 이름이 다를지라도 대부분의 단계는 다른 언어에서도 동일합니다. 선택한 특정 프로젝트 템플릿에 대한 세부 정보는 프로젝트 리포지토리의 README.md 파일을 참조하십시오.

1. 그런 다음 AWS Management Console에 로그인하고 https://console.aws.amazon.com/glue/에서 AWS CodeStar 콘솔을 열 수 있습니다.

2. 프로젝트와 리소스를 생성하려는 AWS 리전을 선택합니다. Alexa skill 실행 시간은 다음 AWS 리전에서만 사용 가능합니다.

   • 아시아 태평양(도쿄)

   • EU(아일랜드)

   • 미국 동부(버지니아 북부)

   • 미국 서부(오레건)

3. 프로젝트 만들기를 선택합니다.

4. 프로젝트 템플릿 선택 페이지에서:

   1. 애플리케이션 유형에서 Alexa Skill을 선택합니다.

   2. 프로그래밍 언어에서 Node.js를 선택합니다.

5. 선택 항목을 포함하는 상자를 선택합니다.

6. 프로젝트 이름에 프로젝트의 이름(예: My Alexa Skill)을 입력합니다. 다른 이름을 사용하는 경우 이 자습서에 이 이름을 사용해야 합니다. AWS CodeStar는 프로젝트 ID(예: my-alexa-skill)의 이 프로젝트에 관련 식별자를 선택합니다. 다른 프로젝트 ID를 사용하는 경우 이 자습서 전체에서 이를 사용해야 합니다.

7. 이 자습서의 리포지토리에 대해 AWS CodeCommit을 선택하고 리포지토리 이름 값을 변경하지 않습니다.

8. Connect Amazon developer account(Amazon 개발자 계정 연결)을 선택하여 스킬 호스팅을 위해 Amazon 개발자 계정에 연결합니다. Amazon 개발자 계정이 없는 경우 먼저 계정을 만들고 Amazon Developers에서 등록을 완료하십시오.

9. Amazon 개발자 자격 증명으로 로그인합니다. 허용을 선택한 다음 확인을 선택하여 연결을 완료합니다.

10. Amazon 개발자 계정과 연결된 공급업체 ID가 여러 개인 경우 이 프로젝트에 사용할 공급업체 ID를 선택합니다. 관리자 또는 개발자 역할이 지정된 계정을 사용하는지 확인합니다.

11. 다음을 선택합니다.

12. (선택 사항) 이 AWS 리전에서 AWS CodeStar를 처음 사용하는 경우 AWS CodeStar에서 사용하려는 표시 이름과 이메일 주소를 IAM 사용자용으로 입력합니다. 다음을 선택합니다.

13. AWS CodeStar가 프로젝트를 생성하는 동안 기다립니다. 몇 분 정도 걸릴 수 있습니다. 프로젝트 프로비저닝 배너가 표시될 때까지 계속하지 마세요.

2단계: Alexa Simulator에서 스킬 테스트

첫 번째 단계에서는 AWS CodeStar이 사용자를 위한 스킬을 생성하여 Alexa skill 개발 단계에 배포했습니다. 다음으로 Alexa Simulator에서 스킬을 테스트합니다.

1. AWS CodeStar 콘솔의 프로젝트에서 애플리케이션 보기를 선택합니다. Alexa Simulator에서 새 탭이 열립니다.

2. 1단계에서 프로젝트에 연결한 계정의 Amazon 개발자 자격 증명으로 로그인합니다.

3. 테스트 아래에서 개발을 선택하여 테스트를 활성화합니다.

4. ask hello node hello을 입력합니다. 스킬의 기본 간접 호출 이름은 hello node입니다.

5. 스킬이 Hello World!에 응답해야 합니다.

Alexa Simulator에서 스킬이 활성화되면 Amazon 개발자 계정에 등록된 Alexa 활성화 디바이스에서 스킬을 간접 호출할 수도 있습니다. 디바이스에 대한 스킬을 테스트하려면 Alexa, hello node에 인사하라고 요청하세요라고 말합니다.

Alexa Simulator에 대한 자세한 내용은 개발자 콘솔에서 스킬 테스트를 참조하십시오.

3단계: 프로젝트 리소스 탐색

프로젝트 생성의 일환으로 AWS CodeStar는 사용자를 대신하여 AWS 리소스를 생성했습니다. 이러한 리소스에는 CodeCommit을 사용하는 프로젝트 리포지토리, CodePipeline을 사용하는 배포 파이프라인 및 AWS Lambda 함수가 포함됩니다. 탐색 모음에서 이러한 리소스에 액세스할 수 있습니다. 예를 들어 리포지토리를 선택하면 CodeCommit 리포지토리에 대한 세부 정보가 표시됩니다. 파이프라인 페이지에서 파이프라인 배포 상태를 볼 수 있습니다. 탐색 모음에서 개요를 선택하여 프로젝트의 일부로 생성된 AWS 리소스의 전체 목록을 볼 수 있습니다. 이 목록에는 각 리소스의 링크가 포함되어 있습니다.

4단계: 스킬 응답 변경

이 단계에서는 반복 주기를 이해하기 위해 스킬의 응답을 약간 변경합니다.

1. 탐색 모음에서 리포지토리를 선택합니다. 리포지토리 이름 아래의 링크를 선택하면 프로젝트 리포지토리가 새 탭 또는 창에 열립니다. 이 리포지토리에는 빌드 사양 (buildspec.yml), AWS CloudFormation 애플리케이션 스택 (template.yml), readme 파일 및 스킬 패키지 형식 (프로젝트 구조)의 스킬 소스 코드가 포함되어 있습니다.

2. lambda > custom > index.js 파일(Node.js.의 경우)로 이동합니다. 이 파일에는 ASK SDK를 사용하는 요청 처리 코드가 들어 있습니다.

3. 편집을 선택합니다.

4. 24행의 문자열 Hello World!을 문자열 Hello. How are you?로 바꿉니다.

5. 파일의 끝까지 스크롤을 내립니다. 작성자 이름과 이메일 주소 및 커밋 메시지(선택 사항)를 입력합니다.

6. 변경 사항 커밋을 선택하여 변경 내용을 리포지토리에 커밋합니다.

7. AWS CodeStar의 프로젝트로 돌아가서 파이프라인 페이지를 확인하세요. 이제 파이프라인 배포가 표시되어야 합니다.

8. 파이프라인 배포가 완료되면 Alexa Simulator에서 다시 스킬을 테스트합니다. 이제 스킬이Hello. How are you?로 응답해야 합니다

5단계: 프로젝트 리포지토리에 연결하기 위해 로컬 워크스테이션 설정

이전에는 CodeCommit 콘솔에서 직접 소스 코드를 약간 변경했습니다. 이 단계에서는 로컬 워크스테이션으로 프로젝트 리포지토리를 구성하여 명령줄이나 선호하는 IDE에서 코드를 편집하고 관리할 수 있습니다. 다음 단계에서는 명령줄 도구를 설정하는 방법을 설명합니다.

1. 필요한 경우 AWS CodeStar의 프로젝트 대시보드로 이동합니다.

2. 탐색 창에서 IDE를 선택합니다.

3. 프로젝트 코드 액세스에서 명령줄 인터페이스 아래의 지침을 확인하세요.

4. 지침을 따라 다음 작업을 완료합니다.

   1. Git 다운로드와 같은 웹 사이트에서 로컬 워크스테이션에 Git을 설치합니다.

   2. AWS CLI를 설치합니다. 자세한 내용은 AWS 명령줄 인터페이스 설치 단원을 참조하세요.

   3. IAM 사용자 액세스 키 및 비밀 키로 AWS CLI를 구성합니다. 자세한 내용은 AWS CLI 구성을 참조하세요.

   4. 프로젝트의 CodeCommit 리포지토리를 로컬 워크스테이션에 복제합니다. 자세한 내용은 CodeCommit 리포지토리에 연결을 참조하세요.

다음 단계

이 자습서에서는 기본 스킬을 시작하는 방법을 보여 주었습니다. 스킬 개발 과정을 계속 진행하려면 다음 리소스를 참조하십시오.

• Alexa 개발자 YouTube 채널에서 Alexa Skills 작업 및 기타 동영상을 시청하여 스킬의 기본 사항을 이해하십시오.

• 스킬 패키지 형식, 스킬 매니페스트 스키마 및 상호 작용 모델 스키마에 대한 설명서를 검토하여 스킬의 다양한 구성 요소를 이해하십시오.

• Alexa Skill 키트 및 ASK SDK에 대한 설명서를 검토하여 아이디어를 스킬로 전환하십시오.