interface SimpleSynthActionProps
Language | Type name |
---|---|
.NET | Amazon.CDK.Pipelines.SimpleSynthActionProps |
Java | software.amazon.awscdk.pipelines.SimpleSynthActionProps |
Python | aws_cdk.pipelines.SimpleSynthActionProps |
TypeScript (source) | @aws-cdk/pipelines » SimpleSynthActionProps |
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Construction props for SimpleSynthAction.
Example
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as codebuild from '@aws-cdk/aws-codebuild';
import * as codepipeline from '@aws-cdk/aws-codepipeline';
import * as ec2 from '@aws-cdk/aws-ec2';
import * as iam from '@aws-cdk/aws-iam';
import * as s3 from '@aws-cdk/aws-s3';
import * as pipelines from '@aws-cdk/pipelines';
declare const artifact: codepipeline.Artifact;
declare const bucket: s3.Bucket;
declare const buildImage: codebuild.IBuildImage;
declare const buildSpec: codebuild.BuildSpec;
declare const policyStatement: iam.PolicyStatement;
declare const subnet: ec2.Subnet;
declare const subnetFilter: ec2.SubnetFilter;
declare const value: any;
declare const vpc: ec2.Vpc;
const simpleSynthActionProps: pipelines.SimpleSynthActionProps = {
cloudAssemblyArtifact: artifact,
sourceArtifact: artifact,
synthCommand: 'synthCommand',
// the properties below are optional
actionName: 'actionName',
additionalArtifacts: [{
artifact: artifact,
directory: 'directory',
}],
buildCommand: 'buildCommand',
buildCommands: ['buildCommands'],
buildSpec: buildSpec,
copyEnvironmentVariables: ['copyEnvironmentVariables'],
environment: {
buildImage: buildImage,
certificate: {
bucket: bucket,
objectKey: 'objectKey',
},
computeType: codebuild.ComputeType.SMALL,
environmentVariables: {
environmentVariablesKey: {
value: value,
// the properties below are optional
type: codebuild.BuildEnvironmentVariableType.PLAINTEXT,
},
},
privileged: false,
},
environmentVariables: {
environmentVariablesKey: {
value: value,
// the properties below are optional
type: codebuild.BuildEnvironmentVariableType.PLAINTEXT,
},
},
installCommand: 'installCommand',
installCommands: ['installCommands'],
projectName: 'projectName',
rolePolicyStatements: [policyStatement],
subdirectory: 'subdirectory',
subnetSelection: {
availabilityZones: ['availabilityZones'],
onePerAz: false,
subnetFilters: [subnetFilter],
subnetGroupName: 'subnetGroupName',
subnetName: 'subnetName',
subnets: [subnet],
subnetType: ec2.SubnetType.ISOLATED,
},
testCommands: ['testCommands'],
vpc: vpc,
};
Properties
Name | Type | Description |
---|---|---|
cloud | Artifact | The artifact where the CloudAssembly should be emitted. |
source | Artifact | The source artifact of the CodePipeline. |
synth | string | The synth command. |
action | string | Name of the build action. |
additional | Additional [] | Produce additional output artifacts after the build based on the given directories. |
build | string | The build command. |
build | string[] | The build commands. |
build | Build | custom BuildSpec that is merged with the generated one. |
copy | string[] | Environment variables to copy over from parent env. |
environment? | Build | Build environment to use for CodeBuild job. |
environment | { [string]: Build } | Environment variables to send into build. |
install | string | The install command. |
install | string[] | Install commands. |
project | string | Name of the CodeBuild project. |
role | Policy [] | Policy statements to add to role used during the synth. |
subdirectory? | string | Directory inside the source where package.json and cdk.json are located. |
subnet | Subnet | Which subnets to use. |
test | string[] | Test commands. |
vpc? | IVpc | The VPC where to execute the SimpleSynth. |
cloudAssemblyArtifact
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
Artifact
The artifact where the CloudAssembly should be emitted.
sourceArtifact
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
Artifact
The source artifact of the CodePipeline.
synthCommand
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
string
The synth command.
actionName?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
string
(optional, default: 'Synth')
Name of the build action.
additionalArtifacts?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
Additional
[]
(optional, default: No additional artifacts generated)
Produce additional output artifacts after the build based on the given directories.
Can be used to produce additional artifacts during the build step, separate from the cloud assembly, which can be used further on in the pipeline.
Directories are evaluated with respect to subdirectory
.
buildCommand?
⚠️ Deprecated: Use buildCommands
instead
Type:
string
(optional, default: No build required)
The build command.
If your programming language requires a compilation step, put the compilation command here.
buildCommands?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
string[]
(optional, default: No build required)
The build commands.
If your programming language requires a compilation step, put the compilation command here.
buildSpec?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
Build
(optional, default: none)
custom BuildSpec that is merged with the generated one.
copyEnvironmentVariables?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
string[]
(optional, default: No environment variables copied)
Environment variables to copy over from parent env.
These are environment variables that are being used by the build.
environment?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
Build
(optional, default: BuildEnvironment.LinuxBuildImage.STANDARD_5_0)
Build environment to use for CodeBuild job.
environmentVariables?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
{ [string]:
Build
}
(optional, default: No additional environment variables)
Environment variables to send into build.
NOTE: You may run into the 1000-character limit for the Action configuration if you have a large
number of variables or if their names or values are very long.
If you do, pass them to the underlying CodeBuild project directly in environment
instead.
However, you will not be able to use CodePipeline Variables in this case.
installCommand?
⚠️ Deprecated: Use installCommands
instead
Type:
string
(optional, default: No install required)
The install command.
If not provided by the build image or another dependency
management tool, at least install the CDK CLI here using
npm install -g aws-cdk
.
installCommands?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
string[]
(optional, default: No install required)
Install commands.
If not provided by the build image or another dependency
management tool, at least install the CDK CLI here using
npm install -g aws-cdk
.
projectName?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
string
(optional, default: Automatically generated)
Name of the CodeBuild project.
rolePolicyStatements?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
Policy
[]
(optional, default: No policy statements added to CodeBuild Project Role)
Policy statements to add to role used during the synth.
Can be used to add acces to a CodeArtifact repository etc.
subdirectory?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
string
(optional, default: Repository root)
Directory inside the source where package.json and cdk.json are located.
subnetSelection?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
Subnet
(optional, default: All private subnets.)
Which subnets to use.
Only used if 'vpc' is supplied.
testCommands?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
string[]
(optional, default: No test commands)
Test commands.
These commands are run after the build commands but before the synth command.
vpc?
⚠️ Deprecated: This class is part of the old API. Use the API based on the CodePipeline
class instead
Type:
IVpc
(optional, default: No VPC)
The VPC where to execute the SimpleSynth.