Tutorial: Create a pipeline that deploys an Amazon Alexa skill - Amazon CodePipeline
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Tutorial: Create a pipeline that deploys an Amazon Alexa skill

In this tutorial, you configure a pipeline that continuously delivers your Alexa skill using the Alexa Skills Kit as the deployment provider in your deployment stage. The completed pipeline detects changes to your skill when you make a change to the source files in your source repository. The pipeline then uses the Alexa Skills Kit to deploy to the Alexa skill development stage.

Note

This feature is not available in the Asia Pacific (Hong Kong) or Europe (Milan) Region. To use other deploy actions available in that Region, see Deploy action integrations.

To create your custom skill as a Lambda function, see Host a Custom Skill as an Amazon Lambda Function. You can also create a pipeline that uses Lambda source files and a CodeBuild project to deploy changes to Lambda for your skill. For example, to create a new skill and related Lambda function, you can create an AWS CodeStar project. See Create an Alexa Skill Project in AWS CodeStar. For that option, the pipeline includes a third build stage with an CodeBuild action and an action in the Deploy stage for Amazon CloudFormation.

Prerequisites

You must already have the following:

Step 1: Create an Alexa developer services LWA security profile

In this section, you create a security profile to use with Login with Amazon (LWA). If you already have a profile, you can skip this step.

  • Use the steps in generate-lwa-tokens to create a Security Profile.

  • After you create the profile, make a note of the Client ID and Client Secret.

  • Make sure you enter the Allowed Return URLs as provided in the instructions. The URLs allow the ASK CLI command to redirect refresh token requests.

Step 2: Create Alexa skill source files and push to your CodeCommit repository

In this section, you create and push your Alexa skill source files to the repository that the pipeline uses for your source stage. For the skill you have created in the Amazon developer console, you produce and push the following:

  • A skill.json file.

  • An interactionModel/custom folder.

    Note

    This directory structure complies with Alexa Skills Kit skill package format requirements, as outlined in Skill package format. If your directory structure does not use the correct skill package format, changes do not successfully deploy to the Alexa Skills Kit console.

To create source files for your skill
  1. Retrieve your skill ID from the Alexa Skills Kit developer console. Use this command:

    ask api list-skills

    Locate your skill by name and then copy the associated ID in the skillId field.

  2. Generate a skill.json file that contains your skill details. Use this command:

    ask api get-skill -s skill-ID > skill.json
  3. (Optional) Create an interactionModel/custom folder.

    Use this command to generate the interaction model file within the folder. For locale, this tutorial uses en-US as the locale in the file name.

    ask api get-model --skill-id skill-ID --locale locale > ./interactionModel/custom/locale.json
To push files to your CodeCommit repository
  1. Push or upload the files to your CodeCommit repository. These files are the source artifact created by the Create Pipeline wizard for your deployment action in Amazon CodePipeline. Your files should look like this in your local directory:

    skill.json /interactionModel /custom |en-US.json
  2. Choose the method you want to use to upload your files:

    1. To use the Git command line from a cloned repository on your local computer:

      1. Run the following command to stage all of your files at once:

        git add -A
      2. Run the following command to commit the files with a commit message:

        git commit -m "Added Alexa skill files"
      3. Run the following command to push the files from your local repo to your CodeCommit repository:

        git push
    2. To use the CodeCommit console to upload your files:

      1. Open the CodeCommit console, and choose your repository from the Repositories list.

      2. Choose Add file, and then choose Upload file.

      3. Choose Choose file, and then browse for your file. Commit the change by entering your user name and email address. Choose Commit changes.

      4. Repeat this step for each file you want to upload.

Step 3: Use ASK CLI commands to create a refresh token

CodePipeline uses a refresh token based on the client ID and secret in your Amazon developer account to authorize actions it performs on your behalf. In this section, you use the ASK CLI to create the token. You use these credentials when you use the Create Pipeline wizard.

To create a refresh token with your Amazon developer account credentials
  1. Use the following command:

    ask util generate-lwa-tokens
  2. When prompted, enter your client ID and secret as shown in this example:

    ? Please type in the client ID: amzn1.application-client.example112233445566 ? Please type in the client secret: example112233445566
  3. The sign-in browser page displays. Sign in with your Amazon developer account credentials.

  4. Return to the command line screen. The access token and refresh token are generated in the output. Copy the refresh token returned in the output.

Step 4: Create your pipeline

In this section, you create a pipeline with the following actions:

  • A source stage with a CodeCommit action where the source artifacts are the Alexa skill files that support your skill.

  • A deployment stage with an Alexa Skills Kit deploy action.

To create a pipeline with the wizard
  1. Sign in to the Amazon Web Services Management Console and open the CodePipeline console at http://console.www.amazonaws.cn/codesuite/codepipeline/home.

  2. Choose the Amazon Region where you want to create the project and its resources. The Alexa skill runtime is available only in the following Regions:

    • Asia Pacific (Tokyo)

    • Europe (Ireland)

    • US East (N. Virginia)

    • US West (Oregon)

  3. On the Welcome page, Getting started page, or the Pipelines page, choose Create pipeline.

  4. In Step 1: Choose pipeline settings, in Pipeline name, enter MyAlexaPipeline.

  5. In Pipeline type, choose V1 for the purposes of this tutorial. You can also choose V2; however, note that pipeline types differ in characteristics and price. For more information, see Pipeline types.

  6. In Service role, choose New service role to allow CodePipeline to create a service role in IAM.

  7. Leave the settings under Advanced settings at their defaults, and then choose Next.

  8. In Step 2: Add source stage, in Source provider, choose Amazon CodeCommit. In Repository name, choose the name of the CodeCommit repository you created in Step 1: Create a CodeCommit repository. In Branch name, choose the name of the branch that contains your latest code update.

    After you select the repository name and branch, a message shows the Amazon CloudWatch Events rule to be created for this pipeline.

    Choose Next.

  9. In Step 3: Add build stage, choose Skip build stage, and then accept the warning message by choosing Skip again.

    Choose Next.

  10. In Step 4: Add deploy stage:

    1. In Deploy provider, choose Alexa Skills Kit.

    2. In Alexa skill ID, enter the skill ID assigned to your skill in the Alexa Skills Kit developer console.

    3. In Client ID, enter the ID of the application you registered.

    4. In Client secret, enter the secret you chose when you registered.

    5. In Refresh token, enter the token you generated in step 3.

      
                                The Step 4: Deploy page for an Alexa Skills Kit
                                    action
    6. Choose Next.

  11. In Step 5: Review, review the information, and then choose Create pipeline.

Step 5: Make a change to any source file and verify deployment

Make a change to your skill and then push the change to your repository. This triggers your pipeline to run. Verify that your skill is updated in the Alexa Skills Kit developer console.