# Pulumi AWS Native Provider (preview)
The Pulumi AWS Native Provider enables you to build, deploy, and manage [any AWS resource that's supported by the AWS Cloud Control API](https://github.com/pulumi/pulumi-aws-native/blob/master/provider/cmd/pulumi-gen-aws-native/supported-types.txt).
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 to [install and configure the Pulumi CLI](https://pulumi.com/docs/get-started/install) if you haven't already.
---
> [!NOTE]
> AWS Native is in public preview.
> This provider covers all resources as supported by the [AWS Cloud Control API](https://aws.amazon.com/cloudcontrolapi/). This does not yet include all AWS resources. See the [list of supported resources](https://github.com/pulumi/pulumi-aws-native/blob/master/provider/cmd/pulumi-gen-aws-native/supported-types.txt) for full details.
For new projects, we recommend using AWS Native and [AWS Classic](https://github.com/pulumi/pulumi-aws) side-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 credentials
To learn how to configure credentials refer to the [AWS configuration options](https://www.pulumi.com/registry/packages/aws-native/installation-configuration/#configuration-options).
## Building
### Dependencies
- Go 1.20
- NodeJS 10.X.X or later
- Yarn 1.22 or later
- Python 3.6 or later
- .NET 6 or greater
- Gradle 7
- Pulumi CLI and language plugins
- pulumictl
You can quickly launch a shell environment with all the required dependencies using
[devbox](https://www.jetpack.io/devbox/):
```bash
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](https://containers.dev/supporting#editors)
such as [VS Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) or [Github Codespaces](https://codespaces.new/pulumi/pulumi-aws-native). 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:
```bash
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
To run unittests, use:
```bash
make test_provider
```
### Running an example
Navigate to the ECS example and run Pulumi:
```bash
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:
```shell
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`).
Raw data
{
"_id": null,
"home_page": null,
"name": "pulumi-aws-native",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "pulumi, aws, aws-native, category/cloud, kind/native",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/03/7f/f3e6e8caacc38e87258b1682f14940ba3da61380c4115b2f7a88190a21e8/pulumi_aws_native-0.105.0.tar.gz",
"platform": null,
"description": "# Pulumi AWS Native Provider (preview)\n\nThe Pulumi AWS Native Provider enables you to build, deploy, and manage [any AWS resource that's supported by the AWS Cloud Control API](https://github.com/pulumi/pulumi-aws-native/blob/master/provider/cmd/pulumi-gen-aws-native/supported-types.txt).\nWith 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.\nYou can use AWS Native from a Pulumi program written in any Pulumi language: C#, Go, JavaScript/TypeScript, and Python.\nYou'll need to [install and configure the Pulumi CLI](https://pulumi.com/docs/get-started/install) if you haven't already.\n\n---\n> [!NOTE]\n> AWS Native is in public preview.\n> This provider covers all resources as supported by the [AWS Cloud Control API](https://aws.amazon.com/cloudcontrolapi/). This does not yet include all AWS resources. See the [list of supported resources](https://github.com/pulumi/pulumi-aws-native/blob/master/provider/cmd/pulumi-gen-aws-native/supported-types.txt) for full details.\n\nFor new projects, we recommend using AWS Native and [AWS Classic](https://github.com/pulumi/pulumi-aws) side-by-side so you can get the speed and correctness benefits of AWS Native where possible.\nFor existing projects, AWS Classic remains fully supported; at this time, we recommend waiting to migrate existing projects to AWS Native.\n\n---\n\n## Configuring credentials\n\nTo learn how to configure credentials refer to the [AWS configuration options](https://www.pulumi.com/registry/packages/aws-native/installation-configuration/#configuration-options).\n\n## Building\n\n### Dependencies\n\n- Go 1.20\n- NodeJS 10.X.X or later\n- Yarn 1.22 or later\n- Python 3.6 or later\n- .NET 6 or greater\n- Gradle 7\n- Pulumi CLI and language plugins\n- pulumictl\n\nYou can quickly launch a shell environment with all the required dependencies using\n[devbox](https://www.jetpack.io/devbox/):\n\n```bash\nwhich devbox || curl -fsSL https://get.jetpack.io/devbox | bash\ndevbox shell\n```\n\nAlternatively, you can develop in a preconfigured container environment using\n[an editor or service that supports the devcontainer standard](https://containers.dev/supporting#editors)\nsuch as [VS Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) or [Github Codespaces](https://codespaces.new/pulumi/pulumi-aws-native). 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.\n\n### Building locally\n\nRun the following commands to install Go modules, generate all SDKs, and build the provider:\n\n```bash\nmake ensure\nmake build\n```\n\nAdd the `bin` folder to your `$PATH` or copy the `bin/pulumi-resource-aws-native` file to another location in your `$PATH`.\n\n### Running tests\n\nTo run unittests, use:\n\n```bash\nmake test_provider\n```\n\n### Running an example\n\nNavigate to the ECS example and run Pulumi:\n\n```bash\ncd ./examples/ecs\nyarn link @pulumi/aws-native\npulumi config set aws:region us-west-2\npulumi config set aws-native:region us-west-2\npulumi up\n```\n\n### Local Development\n\n#### Additional Build Targets\n\n`make build` can be a bit slow as it rebuilds the sdks for every language;\nyou can use `make provider` or `make codegen` to just rebuild the provider plugin or codegen binaries\n\n#### Debugging / Logging\n\nOftentimes, 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:\n\n```shell\npulumi -v 9 --logflow [command]\n```\n\nthis 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`).\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "A native Pulumi package for creating and managing Amazon Web Services (AWS) resources.",
"version": "0.105.0",
"project_urls": {
"Homepage": "https://pulumi.com",
"Repository": "https://github.com/pulumi/pulumi-aws-native"
},
"split_keywords": [
"pulumi",
" aws",
" aws-native",
" category/cloud",
" kind/native"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f109e9561f18de6133bb9be4dfc003611a295e779b9c79b411f35965b90264e2",
"md5": "9a65ae64469fea3167206e4f12b9addd",
"sha256": "4eff06660d49e2583844ad1b5b6ae9175a5381a8e321a55013716833fab55264"
},
"downloads": -1,
"filename": "pulumi_aws_native-0.105.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9a65ae64469fea3167206e4f12b9addd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 6727041,
"upload_time": "2024-05-02T14:15:30",
"upload_time_iso_8601": "2024-05-02T14:15:30.165693Z",
"url": "https://files.pythonhosted.org/packages/f1/09/e9561f18de6133bb9be4dfc003611a295e779b9c79b411f35965b90264e2/pulumi_aws_native-0.105.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "037ff3e6e8caacc38e87258b1682f14940ba3da61380c4115b2f7a88190a21e8",
"md5": "89fb7346a39e73f7400da6cda3399dbc",
"sha256": "f7a9d6ac169be8a7f8e0d4db5930b61ef36bb6710eda0561d932c3fcaf80bd10"
},
"downloads": -1,
"filename": "pulumi_aws_native-0.105.0.tar.gz",
"has_sig": false,
"md5_digest": "89fb7346a39e73f7400da6cda3399dbc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4355201,
"upload_time": "2024-05-02T14:15:37",
"upload_time_iso_8601": "2024-05-02T14:15:37.578786Z",
"url": "https://files.pythonhosted.org/packages/03/7f/f3e6e8caacc38e87258b1682f14940ba3da61380c4115b2f7a88190a21e8/pulumi_aws_native-0.105.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-02 14:15:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pulumi",
"github_project": "pulumi-aws-native",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pulumi-aws-native"
}
JSON
