Package: pulumi-aws-native
Pulumi AWS Native Provider (preview)The Pulumi AWS Native Provider enables you to build, deploy, and manageany AWS resource that's supported by the AWS Cloud Control API.
With AWS Native, 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 AWS Native from a Pulumi program written in any Pulumi language: C#, Go, JavaScript/TypeScript, and Python.
You'll need toinstall and configure the Pulumi CLIif you haven't already.[!NOTE]
AWS Native is in public preview.
This provider covers all resources as supported by theAWS Cloud Control API. This does not yet include all AWS resources. See thelist of supported resourcesfor full details.For new projects, we recommend using AWS Native andAWS Classicside-by-side so you can get the speed and correctness benefits of AWS Native where possible.
For existing projects, AWS Classic remains fully supported; at this time, we recommend waiting to migrate existing projects to AWS Native.Configuring credentialsTo learn how to configure credentials refer to theAWS configuration options.BuildingDependenciesGo 1.20NodeJS 10.X.X or laterYarn 1.22 or laterPython 3.6 or later.NET 6 or greaterGradel 7Pulumi CLI and language pluginspulumictlYou can quickly launch a shell environment with all the required dependencies usingdevbox:whichdevbox||curl-fsSLhttps://get.jetpack.io/devbox|bash
devboxshellAlternatively, you can develop in a preconfigured container environment usingan editor or service that supports the devcontainer standardsuch asVS CodeorGithub 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 locallyRun the following commands to install Go modules, generate all SDKs, and build the provider:makeensure
makebuildAdd thebinfolder to your$PATHor copy thebin/pulumi-resource-aws-nativefile to another location in your$PATH.Running testsTo run unittests, use:maketest_providerRunning an exampleNavigate to the ECS example and run Pulumi:cd./examples/ecs
yarnlink@pulumi/aws-native
pulumiconfigsetaws:regionus-west-2
pulumiconfigsetaws-native:regionus-west-2
pulumiupLocal DevelopmentAdditional Build Targetsmake buildcan be a bit slow as it rebuilds the sdks for every language;
you can usemake providerormake codegento just rebuild the provider plugin or codegen binariesDebugging / LoggingOftentimes, 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--logtostderrflag). 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-v9--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).