[](https://github.com/pulumi/pulumi-awsx/actions)
[](https://slack.pulumi.com)
[](https://www.npmjs.com/package/@pulumi/awsx)
[](https://pypi.org/project/pulumi-awsx)
[](https://badge.fury.io/nu/pulumi.awsx)
[](https://pkg.go.dev/github.com/pulumi/pulumi-awsx/sdk/go)
[](https://github.com/pulumi/pulumi-awsx/blob/master/LICENSE)
## Pulumi AWS Infrastructure Components
Pulumi's framework for Amazon Web Services (AWS) infrastructure.
To use this package, [install the Pulumi CLI](https://www.pulumi.com/docs/get-started/install/). For a streamlined Pulumi walkthrough, including language runtime installation and AWS configuration, see the [Crosswalk for AWS documentation](https://www.pulumi.com/docs/guides/crosswalk/aws/).
The AWS Infrastructure package is intended to provide [component](https://www.pulumi.com/docs/intro/concepts/resources/components/) wrappers around many core AWS 'raw' resources to make them easier and more convenient to use. In general, the `@pulumi/awsx` package mirrors the module structure of `@pulumi/aws` (i.e. `@pulumi/awsx/ecs` or `@pulumi/awsx/ec2`). These [components](https://www.pulumi.com/docs/intro/concepts/resources/components/) are designed to take care of much of the redundancy and boilerplate necessary when using the raw AWS resources, while still striving to expose all underlying functionality if needed.
The AWS Infrastructure package undergoes constant improvements and additions. While we will strive to maintain backward compatibility here, we will occasionally make breaks here as appropriate if it helps improve the overall quality of this package.
The AWS Infrastructure package exposes many high level abstractions. Including:
* [`ec2`](https://github.com/pulumi/pulumi-awsx/blob/master/awsx/ec2). A module that makes it easier to work with your AWS network, subnets, and security groups. By default, the resources in the package follow the [AWS Best Practices](
https://aws.amazon.com/answers/networking/aws-single-vpc-design/), but can be configured as desired in whatever ways you want. Most commonly, this package is used to acquire the default Vpc for a region (using `awsx.ec2.DefaultNetwork`). However, it can also be used to easily create or augment an existing Vpc.
* [`ecs`](https://github.com/pulumi/pulumi-awsx/blob/master/awsx/ecs). A module that makes it easy to create and configure clusters, tasks and services for running containers. Convenience resources are created to make the common tasks of creating EC2 or Fargate services and tasks much simpler.
* [`lb`](https://github.com/pulumi/pulumi-awsx/tree/master/awsx/lb). A module for simply setting up [Elastic Load Balancing](https://aws.amazon.com/elasticloadbalancing/). This module provides convenient ways to set up either `Network` or `Application` load balancers, along with the appropriate ELB Target Groups and Listeners in order to have a high availability, automatically-scaled service. These ELB components also work well with the other awsx components. For example, an `lb.defaultTarget` can be passed in directly as the `portMapping` target of an `ecs.FargateService`.
<div>
<a href="https://www.pulumi.com/docs/guides/crosswalk/aws/" title="Get Started">
<img src="https://www.pulumi.com/images/get-started.svg?" width="120">
</a>
</div>
## Installing
This package is available in many languages in the standard packaging formats.
### Node.js (Java/TypeScript)
To use from JavaScript or TypeScript in Node.js, install using either `npm`:
```bash
npm install @pulumi/awsx
```
or `yarn`:
```bash
yarn add @pulumi/awsx
```
### Python
To use from Python, install using `pip`:
```bash
pip install pulumi-awsx
```
### Go
To use from Go, use `go get` to grab the latest version of the library
```bash
go get github.com/pulumi/pulumi-awsx/sdk
```
### .NET
To use from .NET, install using `dotnet add package`:
```bash
dotnet add package Pulumi.Awsx
```
## Configuration
The configuration options available for this provider mirror those of the [Pulumi AWS Classic Provider](https://github.com/pulumi/pulumi-aws#configuration)
### Custom AWS Provider Versions
Pulumi dependency resolution may result in `awsx.*` resources using a different version of the AWS Classic Provider than
the rest of the program. The version used by default is fixed for each `@pulumi/awsx` release and can be found in
[package.json](https://github.com/pulumi/pulumi-awsx/blob/master/awsx/package.json#L25). When this becomes problematic,
for example a newer version of AWS Classic Provider is desired, it can be specified explicitly. For example, in Python:
```python
import pulumi
import pulumi_aws as aws
import pulumi_awsx as awsx
awsp = aws.Provider("awsp", opts=pulumi.ResourceOptions(version="6.36.0"))
lb = awsx.lb.ApplicationLoadBalancer("lb", opts=pulumi.ResourceOptions(providers={"aws": awsp}))
```
## Migration from 0.x to 1.0
Before version 1, this package only supported components in TypeScript. All the existing components from the 0.x releases are now available in the `classic` namespace. The `classic` namespace will remain until the next major version release but will only receive updates for critical security fixes.
1. Change references from `@pulumi/awsx` to `@pulumi/awsx/classic` to maintain existing behaviour.
2. Refactor to replace the classic components with the new top-level components.
**Note:** The new top-level components (outside the `classic` namespace) may require additional code changes and resource re-creation.
### Notable changes
- Removed ECS Cluster as this did not add any functionality over the [AWS Classic ECS Cluster resource](https://www.pulumi.com/registry/packages/aws/api-docs/ecs/cluster/).
- Removed `Vpc.fromExistingIds()` as this was originally added because other components depended on the concrete VPC component class. The new components in v1 no longer have hard dependencies on other resources, so instead the subnets from the existing VPC can be passed into other components directly.
## References
* [Tutorial](https://www.pulumi.com/blog/crosswalk-for-aws-1-0/)
* [API Reference Documentation](https://www.pulumi.com/registry/packages/awsx/api-docs/)
* [Examples](./examples)
* [Crosswalk for AWS Guide](https://www.pulumi.com/docs/guides/crosswalk/aws/)
Raw data
{
"_id": null,
"home_page": null,
"name": "pulumi-awsx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "pulumi, aws, awsx, kind/component, category/cloud",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/1c/7c/cf4629c9266dc0ac09094d7ab40d1617c6f8f19cbbad8a39024fb27bc5bd/pulumi_awsx-2.21.0.tar.gz",
"platform": null,
"description": "[](https://github.com/pulumi/pulumi-awsx/actions)\n[](https://slack.pulumi.com)\n[](https://www.npmjs.com/package/@pulumi/awsx)\n[](https://pypi.org/project/pulumi-awsx)\n[](https://badge.fury.io/nu/pulumi.awsx)\n[](https://pkg.go.dev/github.com/pulumi/pulumi-awsx/sdk/go)\n[](https://github.com/pulumi/pulumi-awsx/blob/master/LICENSE)\n\n## Pulumi AWS Infrastructure Components\n\nPulumi's framework for Amazon Web Services (AWS) infrastructure.\n\nTo use this package, [install the Pulumi CLI](https://www.pulumi.com/docs/get-started/install/). For a streamlined Pulumi walkthrough, including language runtime installation and AWS configuration, see the [Crosswalk for AWS documentation](https://www.pulumi.com/docs/guides/crosswalk/aws/).\n\nThe AWS Infrastructure package is intended to provide [component](https://www.pulumi.com/docs/intro/concepts/resources/components/) wrappers around many core AWS 'raw' resources to make them easier and more convenient to use. In general, the `@pulumi/awsx` package mirrors the module structure of `@pulumi/aws` (i.e. `@pulumi/awsx/ecs` or `@pulumi/awsx/ec2`). These [components](https://www.pulumi.com/docs/intro/concepts/resources/components/) are designed to take care of much of the redundancy and boilerplate necessary when using the raw AWS resources, while still striving to expose all underlying functionality if needed.\n\nThe AWS Infrastructure package undergoes constant improvements and additions. While we will strive to maintain backward compatibility here, we will occasionally make breaks here as appropriate if it helps improve the overall quality of this package.\n\nThe AWS Infrastructure package exposes many high level abstractions. Including:\n\n* [`ec2`](https://github.com/pulumi/pulumi-awsx/blob/master/awsx/ec2). A module that makes it easier to work with your AWS network, subnets, and security groups. By default, the resources in the package follow the [AWS Best Practices](\n https://aws.amazon.com/answers/networking/aws-single-vpc-design/), but can be configured as desired in whatever ways you want. Most commonly, this package is used to acquire the default Vpc for a region (using `awsx.ec2.DefaultNetwork`). However, it can also be used to easily create or augment an existing Vpc.\n\n* [`ecs`](https://github.com/pulumi/pulumi-awsx/blob/master/awsx/ecs). A module that makes it easy to create and configure clusters, tasks and services for running containers. Convenience resources are created to make the common tasks of creating EC2 or Fargate services and tasks much simpler.\n\n* [`lb`](https://github.com/pulumi/pulumi-awsx/tree/master/awsx/lb). A module for simply setting up [Elastic Load Balancing](https://aws.amazon.com/elasticloadbalancing/). This module provides convenient ways to set up either `Network` or `Application` load balancers, along with the appropriate ELB Target Groups and Listeners in order to have a high availability, automatically-scaled service. These ELB components also work well with the other awsx components. For example, an `lb.defaultTarget` can be passed in directly as the `portMapping` target of an `ecs.FargateService`.\n\n<div>\n <a href=\"https://www.pulumi.com/docs/guides/crosswalk/aws/\" title=\"Get Started\">\n <img src=\"https://www.pulumi.com/images/get-started.svg?\" width=\"120\">\n </a>\n</div>\n\n## Installing\n\nThis package is available in many languages in the standard packaging formats.\n\n### Node.js (Java/TypeScript)\n\nTo use from JavaScript or TypeScript in Node.js, install using either `npm`:\n\n```bash\nnpm install @pulumi/awsx\n```\n\nor `yarn`:\n\n```bash\nyarn add @pulumi/awsx\n```\n\n### Python\n\nTo use from Python, install using `pip`:\n\n```bash\npip install pulumi-awsx\n```\n\n### Go\n\nTo use from Go, use `go get` to grab the latest version of the library\n\n```bash\ngo get github.com/pulumi/pulumi-awsx/sdk\n```\n\n### .NET\n\nTo use from .NET, install using `dotnet add package`:\n\n```bash\ndotnet add package Pulumi.Awsx\n```\n\n## Configuration\n\nThe configuration options available for this provider mirror those of the [Pulumi AWS Classic Provider](https://github.com/pulumi/pulumi-aws#configuration)\n\n### Custom AWS Provider Versions\n\nPulumi dependency resolution may result in `awsx.*` resources using a different version of the AWS Classic Provider than\nthe rest of the program. The version used by default is fixed for each `@pulumi/awsx` release and can be found in\n[package.json](https://github.com/pulumi/pulumi-awsx/blob/master/awsx/package.json#L25). When this becomes problematic,\nfor example a newer version of AWS Classic Provider is desired, it can be specified explicitly. For example, in Python:\n\n```python\nimport pulumi\nimport pulumi_aws as aws\nimport pulumi_awsx as awsx\n\nawsp = aws.Provider(\"awsp\", opts=pulumi.ResourceOptions(version=\"6.36.0\"))\nlb = awsx.lb.ApplicationLoadBalancer(\"lb\", opts=pulumi.ResourceOptions(providers={\"aws\": awsp}))\n```\n\n## Migration from 0.x to 1.0\n\nBefore version 1, this package only supported components in TypeScript. All the existing components from the 0.x releases are now available in the `classic` namespace. The `classic` namespace will remain until the next major version release but will only receive updates for critical security fixes.\n\n1. Change references from `@pulumi/awsx` to `@pulumi/awsx/classic` to maintain existing behaviour.\n2. Refactor to replace the classic components with the new top-level components.\n\n**Note:** The new top-level components (outside the `classic` namespace) may require additional code changes and resource re-creation.\n\n### Notable changes\n\n- Removed ECS Cluster as this did not add any functionality over the [AWS Classic ECS Cluster resource](https://www.pulumi.com/registry/packages/aws/api-docs/ecs/cluster/).\n- Removed `Vpc.fromExistingIds()` as this was originally added because other components depended on the concrete VPC component class. The new components in v1 no longer have hard dependencies on other resources, so instead the subnets from the existing VPC can be passed into other components directly.\n\n## References\n\n* [Tutorial](https://www.pulumi.com/blog/crosswalk-for-aws-1-0/)\n* [API Reference Documentation](https://www.pulumi.com/registry/packages/awsx/api-docs/)\n* [Examples](./examples)\n* [Crosswalk for AWS Guide](https://www.pulumi.com/docs/guides/crosswalk/aws/)\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Pulumi Amazon Web Services (AWS) AWSX Components.",
"version": "2.21.0",
"project_urls": {
"Homepage": "https://pulumi.com",
"Repository": "https://github.com/pulumi/pulumi-awsx"
},
"split_keywords": [
"pulumi",
" aws",
" awsx",
" kind/component",
" category/cloud"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "880fe69999747c129d42443eca8772df9b6bc0a7589868d443fbf6557caac6c4",
"md5": "582dac091519210b03d989d90888795a",
"sha256": "8e08e9a5d44fd56a1c05c3365836c5fff1730266a97381b756ea0e1b009f7d0e"
},
"downloads": -1,
"filename": "pulumi_awsx-2.21.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "582dac091519210b03d989d90888795a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 119829,
"upload_time": "2025-01-16T16:34:18",
"upload_time_iso_8601": "2025-01-16T16:34:18.759378Z",
"url": "https://files.pythonhosted.org/packages/88/0f/e69999747c129d42443eca8772df9b6bc0a7589868d443fbf6557caac6c4/pulumi_awsx-2.21.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1c7ccf4629c9266dc0ac09094d7ab40d1617c6f8f19cbbad8a39024fb27bc5bd",
"md5": "b55979f449daa928a2489dd916608b38",
"sha256": "12cfa5a15cb712acc4fbe0e7e23d079450df9877fdbcfafe97c84ec85f222f86"
},
"downloads": -1,
"filename": "pulumi_awsx-2.21.0.tar.gz",
"has_sig": false,
"md5_digest": "b55979f449daa928a2489dd916608b38",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 103631,
"upload_time": "2025-01-16T16:34:19",
"upload_time_iso_8601": "2025-01-16T16:34:19.942041Z",
"url": "https://files.pythonhosted.org/packages/1c/7c/cf4629c9266dc0ac09094d7ab40d1617c6f8f19cbbad8a39024fb27bc5bd/pulumi_awsx-2.21.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-16 16:34:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pulumi",
"github_project": "pulumi-awsx",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pulumi-awsx"
}
JSON
