AWS CDK Resolver
The AwsCdkResolver is able to resolve any CfnOutput
defined by your AWS CDK application. In this example, we create an S3 Bucket with the AWS CDK, and pass its (deploy time generated)
name as an environment variable to a Kubernetes CronJob resource.
import * as aws from 'aws-cdk-lib';
import * as k8s from 'cdk8s';
import * as kplus from 'cdk8s-plus-27';
import { AwsCdkResolver } from '@cdk8s/awscdk-resolver';
const awsApp = new aws.App();
const stack = new aws.Stack(awsApp, 'aws');
const k8sApp = new k8s.App({ resolvers: [new AwsCdkResolver()] });
const manifest = new k8s.Chart(k8sApp, 'Manifest');
const bucket = new aws.aws_s3.Bucket(stack, 'Bucket');
const bucketName = new aws.CfnOutput(stack, 'BucketName', {
value: bucket.bucketName,
});
new kplus.CronJob(manifest, 'CronJob', {
schedule: k8s.Cron.daily(),
containers: [{
image: 'job',
envVariables: {
// directly passing the value of the `CfnOutput` containing
// the deploy time bucket name
BUCKET_NAME: kplus.EnvValue.fromValue(bucketName.value),
}
}]
});
awsApp.synth();
k8sApp.synth();
During cdk8s synthesis, the custom resolver will detect that bucketName.value is not a concrete value,
but rather a value of a CfnOutput. It will then perform AWS service calls in order to fetch the
actual value from the deployed infrastructure in your account. This means that in order
for cdk8s synth to succeed, it must be executed after the AWS CDK resources
have been deployed. So your deployment workflow should (conceptually) be:
cdk deploycdk8s synth
Note that the
AwsCdkResolveris only able to fetch tokens that have aCfnOutputdefined for them.
Permissions
Since running cdk8s synth will now require performing AWS service calls, it must have access
to a set of AWS credentials. Following are the set of actions the credentials must allow:
cloudformation:DescribeStacks
Note that the actions cdk8s require are far more scoped down than those normally required for the
deployment of AWS CDK applications. It is therefore recommended to not reuse the same set of credentials,
and instead create a scoped down ReadOnly role dedicated for cdk8s resolvers.
Cross Repository Workflow
As we've seen, your cdk8s application needs access to the objects defined in your cloud application. If both applications
are defined within the same file, this is trivial to achieve. If they are in different files, a simple import statement will suffice.
However, what if the applications are managed in two separate repositories? This makes it a little trickier, but still possible.
In this scenario, cdk.ts in the AWS CDK application, stored in a dedicated repository.
import * as aws from 'aws-cdk-lib';
const awsApp = new aws.App();
const stack = new aws.Stack(awsApp, 'aws');
const bucket = new aws.aws_s3.Bucket(stack, 'Bucket');
const bucketName = new aws.CfnOutput(stack, 'BucketName', {
value: bucket.bucketName,
});
awsApp.synth();
In order for the cdk8s application to have cross repository access, the AWS CDK object instances that we want to expose need to be available
via a package repository. To do this, break up the AWS CDK application into the following files:
app.ts
import * as aws from 'aws-cdk-lib';
const awsApp = new aws.App();
const stack = new aws.Stack(awsApp, 'aws');
const bucket = new aws.aws_s3.Bucket(stack, 'Bucket');
// export the thing we want to have available for cdk8s applications
export const bucketName = new aws.CfnOutput(stack, 'BucketName', {
value: bucket.bucketName,
});
// note that we don't call awsApp.synth here
main.ts
import { awsApp } from './app.ts'
awsApp.synth();
Now, publish the app.ts file to a package manager, so that your cdk8s application can install and import it.
This approach might be somewhat counter intuitive, because normally we only publish classes to the package manager,
not instances. Indeed, these types of applications introduce a new use-case that requires the sharing of instances.
Conceptually, this is no different than writing state* to an SSM parameter or an S3 bucket, and it allows us to remain
in the boundaries of our programming language, and the typing guarantees it provides.
* Actually, we are only publishing instructions for fetching state, not the state itself.
Assuming app.ts was published as the my-cdk-app package, our cdk8s application will now look like so:
import * as k8s from 'cdk8s';
import * as kplus from 'cdk8s-plus-27';
// import the desired instance from the AWS CDK app.
import { bucketName } from 'my-cdk-app';
import { AwsCdkResolver } from '@cdk8s/awscdk-resolver';
const k8sApp = new k8s.App({ resolvers: [new AwsCdkResolver()] });
const manifest = new k8s.Chart(k8sApp, 'Manifest');
new kplus.CronJob(manifest, 'CronJob', {
schedule: k8s.Cron.daily(),
containers: [{
image: 'job',
envVariables: {
// directly passing the value of the `CfnOutput` containing
// the deploy time bucket name
BUCKET_NAME: kplus.EnvValue.fromValue(bucketName.value),
}
}]
});
k8sApp.synth();
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cdk8s_awscdk_resolver-0.0.644.tar.gz.
File metadata
- Download URL: cdk8s_awscdk_resolver-0.0.644.tar.gz
- Upload date:
- Size: 1.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b289ac4cf0725e122f267df0ffa6301c0a19de36e7a7c9f69e340d9ae5274092
|
|
| MD5 |
c3005ad73f6308dbfee453f2e06c282f
|
|
| BLAKE2b-256 |
cf4a842440a0a9038120fd1048e74d399e80d586142e29457fedac37e0c69b13
|
Provenance
The following attestation bundles were made for cdk8s_awscdk_resolver-0.0.644.tar.gz:
Publisher:
release.yml on cdk8s-team/cdk8s-awscdk-resolver
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cdk8s_awscdk_resolver-0.0.644.tar.gz -
Subject digest:
b289ac4cf0725e122f267df0ffa6301c0a19de36e7a7c9f69e340d9ae5274092 - Sigstore transparency entry: 2328527295
- Sigstore integration time:
-
Permalink:
cdk8s-team/cdk8s-awscdk-resolver@597740a4ee120ef358fff3d1a422b9c2d30834a7 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/cdk8s-team
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@597740a4ee120ef358fff3d1a422b9c2d30834a7 -
Trigger Event:
push
-
Statement type:
File details
Details for the file cdk8s_awscdk_resolver-0.0.644-py3-none-any.whl.
File metadata
- Download URL: cdk8s_awscdk_resolver-0.0.644-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c35d503a9240f732055183b62d9370575be5ffde9f09bf76e49f3e6952efef3f
|
|
| MD5 |
f18cfeeefd065b15fe78338bdfcc81f0
|
|
| BLAKE2b-256 |
dc141f7b9acdd2f7cd39eb07134485a45104a7923f1728db1899b2e575d247d4
|
Provenance
The following attestation bundles were made for cdk8s_awscdk_resolver-0.0.644-py3-none-any.whl:
Publisher:
release.yml on cdk8s-team/cdk8s-awscdk-resolver
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cdk8s_awscdk_resolver-0.0.644-py3-none-any.whl -
Subject digest:
c35d503a9240f732055183b62d9370575be5ffde9f09bf76e49f3e6952efef3f - Sigstore transparency entry: 2328526919
- Sigstore integration time:
-
Permalink:
cdk8s-team/cdk8s-awscdk-resolver@597740a4ee120ef358fff3d1a422b9c2d30834a7 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/cdk8s-team
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@597740a4ee120ef358fff3d1a422b9c2d30834a7 -
Trigger Event:
push
-
Statement type:
