Pulumi AWS Cloud Control Provider
The Pulumi AWS Cloud Control Provider enables you to build, deploy, and manage any AWS resource that's supported by the AWS Cloud Control API. With Pulumi's native provider for AWS Cloud Control, you get same-day access to all new AWS resources and all new properties on existing resources supported by the Cloud Control API. You can use the AWS Cloud Control provider from a Pulumi program written in any Pulumi language: C#, Go, JavaScript/TypeScript, and Python. You'll need to install and configure the Pulumi CLI if you haven't already.
For new projects, we recommend starting with our primary AWS Provider and adding AWS Cloud Control resources on an as needed basis.
Configuring credentials
To learn how to configure credentials refer to the AWS configuration options.
Building
Dependencies
- Go (pinned in
.config/mise.toml) - Node.js 20.x
- Yarn 1.22 or later
- Python 3.11.x
- .NET 8.x
- Gradle 7
- Pulumi CLI and language plugins
- pulumictl
Quick start: make prepare_local_workspace installs pinned toolchain versions via mise.
You can quickly launch a shell environment with all the required dependencies using devbox:
which devbox || curl -fsSL https://get.jetpack.io/devbox | bash
devbox shell
Alternatively, you can develop in a preconfigured container environment using an editor or service that supports the devcontainer standard such as VS Code or Github Codespaces. Please note that building this project can be fairly memory intensive, if you are having trouble building in a container, please ensure you have at least 12GB of memory available for the container.
Building locally
Run the following commands to install Go modules, generate all SDKs, and build the provider:
make ensure
make build
Add the bin folder to your $PATH or copy the bin/pulumi-resource-aws-native file to another location in your $PATH.
Running tests
Fast local verification:
make verify
Provider unit tests:
make test_provider
Examples/integration tests (slow):
make test
Running an example
Navigate to the ECS example and run Pulumi:
cd ./examples/ecs
yarn link @pulumi/aws-native
pulumi config set aws:region us-west-2
pulumi config set aws-native:region us-west-2
pulumi up
Local Development
Additional Build Targets
make build can be a bit slow as it rebuilds the sdks for every language;
you can use make provider or make codegen to just rebuild the provider plugin or codegen binaries
Debugging / Logging
Oftentimes, it can be informative to investigate the precise requests this provider makes to upstream AWS APIs. By default, the Pulumi CLI writes all of its logs to files rather than stdout or stderr (though this can be overridden with the --logtostderr flag). This works to our benefit, however, as the AWS SDK used in this provider writes to stderr by default. To view a trace of all HTTP requests and responses between this provider and AWS APIs, run the Pulumi CLI with the following arguments:
pulumi -v 9 --logflow [command]
this will correctly set verbosity to the level that the provider expects to log these requests (via -v 9), as well as flowing that verbosity setting down from the Pulumi CLI to the provider itself (via --logflow).
1 maintainer
Release files for pulumi-aws-native 1.81.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pulumi_aws_native-1.81.0.tar.gz | 10.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pulumi_aws_native-1.81.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.1 MB
Release files / pulumi_aws_native-1.81.0.tar.gz
| Download URL | pulumi_aws_native-1.81.0.tar.gz |
|---|---|
| Size | 10.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
74d58ae546f05bbd525e592546e9d80401526311fd5cb62b4ce85473a75a1f22
|
|
BLAKE2b-256 checksum How to use checksums |
068423578c99f0a311075bc2b32a8e2169288a4663dea2f1f7de244a7da5d99d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.15
|
Release files / pulumi_aws_native-1.81.0-py3-none-any.whl
| Download URL | pulumi_aws_native-1.81.0-py3-none-any.whl |
|---|---|
| Size | 14.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ff25e25d5bcd6bc1072320ffb9e8cde0a88cbb1a4d11287b2073ef5bff8c377a
|
|
BLAKE2b-256 checksum How to use checksums |
17e6a459193d7daae3642c6ab367af2c46aa33e893813f67a423a17c5a50d7ad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.15
|
