@aws-cdk/alexa-ask

Alexa Ask Construct Library

const alexaAsk = require('@aws-cdk/alexa-ask');

Alexa as deploy target for CodePipeline

You can deploy to Alexa using CodePipeline with the following DeployAction.

// Read the secrets from ParameterStore
const clientId = new cdk.SecretParameter(this, 'AlexaClientId', { ssmParameter: '/Alexa/ClientId' });
const clientSecret = new cdk.SecretParameter(this, 'AlexaClientSecret', { ssmParameter: '/Alexa/ClientSecret' });
const refreshToken = new cdk.SecretParameter(this, 'AlexaRefreshToken', { ssmParameter: '/Alexa/RefreshToken' });

// Add deploy action
new alexaAsk.AlexaSkillDeployAction({
  actionName: 'DeploySkill',
  runOrder: 1,
  inputArtifact: sourceAction.outputArtifact,
  clientId: clientId.value,
  clientSecret: clientSecret.value,
  refreshToken: refreshToken.value,
  skillId: 'amzn1.ask.skill.12345678-1234-1234-1234-123456789012',
});

If you need manifest overrides you can specify them as parameterOverridesArtifact in the action:

const cloudformation = require('@aws-cdk/aws-cloudformation');

// Deploy some CFN change set and store output
const executeChangeSetAction = new cloudformation.PipelineExecuteChangeSetAction({
  actionName: 'ExecuteChangesTest',
  runOrder: 2,
  stackName,
  changeSetName,
  outputFileName: 'overrides.json',
  outputArtifactName: 'CloudFormation',
});

// Provide CFN output as manifest overrides
new alexaAsk.AlexaSkillDeployAction({
  actionName: 'DeploySkill',
  runOrder: 1,
  inputArtifact: sourceAction.outputArtifact,
  parameterOverridesArtifact: executeChangeSetAction.outputArtifact,
  clientId: clientId.value,
  clientSecret: clientSecret.value,
  refreshToken: refreshToken.value,
  skillId: 'amzn1.ask.skill.12345678-1234-1234-1234-123456789012',
});

Changelog

0.27.0 (2019-03-28)

Highlights

• Python support (experimental)
• You can now run the CLI through npx cdk
• Make sure to go through the BREAKING CHANGES section below

Bug Fixes

• autoscaling: verify public subnets for associatePublicIpAddress (#2077) (1e3d41e)
• ec2: descriptive error message when selecting 0 subnets (#2025) (0de2206), closes #2011
• lambda: use Alias ARN directly (#2091) (bc40494)
• rds: remove Instance class (#2081) (6699fed)
• secretsmanager: allow templated string creation (#2010) (4e105a3)
• secretsmanager/ssm: verify presence of parameter name (#2066) (b93350f)
• serverless: rename aws-serverless to aws-sam (#2074) (4a82f13)
• stepfunctions: make Fail.error optional (#2042) (86e9d03)

Code Refactoring

• readonly struct properties and hide internals (#2106) (66dd228), closes awslabs/cdk-ops#321

Features

• toolkit:: new 'cdk' package to allow executing the cli through npx cdk (#2113) (32bca05)
• Python Support (#2009) (e6083fa)
• core: present reason for cyclic references (#2061) (e82e208)
• lambda: add support for log retention (#2067) (63132ec), closes #667 #667
• rds: cluster retention, reference KMS key by object (#2063) (99ab46d)
• secretsmanager/rds: support credential rotation (#2052) (bf79c82)
• toolkit: introduce the concept of auto-deployed Stacks. (#2046) (abacc66)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• lambda: cloudWatchLogsRetentionTimeDays in @aws-cdk/aws-cloudtrail now uses a logs.RetentionDays instead of a LogRetention.
• core: stack._toCloudFormation method is now unavailable and is replaced by @aws-cdk/assert.SynthUtils.toCloudFormation(stack).
• rds: replaced kmsKeyArn: string by kmsKey: kms.IEncryptionKey in DatabaseClusterProps
• autoscaling: VpcNetwork.isPublicSubnet() has been renamed to VpcNetwork.isPublicSubnetIds().
• serverless: renamed aws-serverless to aws-sam
• ec2: vpcPlacement has been renamed to vpcSubnets on all objects, subnetsToUse has been renamed to subnetType. natGatewayPlacement has been renamed to natGatewaySubnets.
• All properties of all structs (interfaces that do not begin with an "I") are now readonly since it is passed by-value and not by-ref (Python is the first language to require that). This may impact code in all languages that assumed it is possible to mutate these structs. Let us know if this blocks you in any way.