LocalStack ECS Container Metadata Endpoints Extension
===============================
[](https://app.localstack.cloud/extensions/remote?url=git+https://github.com/the-wondersmith/localstack-extension-ecs-container-endpoints/#egg=localstack_extension_ecs_container_endpoints)
[//]: # (https://github.com/awslabs/amazon-ecs-local-container-endpoints)
An extension enabling LocalStack to provide local versions of
the [ECS Task IAM Roles endpoint](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) and
the [ECS Task Metadata Endpoints](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html).
Get the full [`amazon-ecs-local-container-endpoints`](https://github.com/awslabs/amazon-ecs-local-container-endpoints)
functionality directly in LocalStack without needing to have additional containers running!
The `amazon-ecs-local-container-endpoints` API is served through both the hostname
`http://metadata.ecs.localhost.localstack.cloud:4566` and
the [official "well-known" IP address](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v2.html#task-metadata-endpoint-v2-paths)
`http://169.254.170.2`.
## Install
Install the extension by running:
```bash
localstack extensions install localstack-extension-ecs-container-endpoints
```
## Usage
### Configuration
The extension passes all environment variables prefixed with `ECS_LOCAL_CONTAINER_ENDPOINTS_` (*with a few
exceptions)
through to the
`amazon-ecs-local-container-endpoints`
process. See
the [upstream docs](https://github.com/awslabs/amazon-ecs-local-container-endpoints/blob/mainline/docs/configuration.md#environment-variables)
for information on configuring `amazon-ecs-local-container-endpoints`.
> [!IMPORTANT]
> Some environment variables are forcibly set to ensure the`amazon-ecs-local-container-endpoints` process
> targets the running LocalStack instance. Specifically, the following environment variables will be ignored:
> - IAM_ENDPOINT
> - STS_ENDPOINT
> - ECS_LOCAL_METADATA_PORT
## Licensing
* `amazon-ecs-local-container-endpoints` is licensed under
the [Apache License 2.0](https://github.com/awslabs/amazon-ecs-local-container-endpoints/blob/mainline/LICENSE)
* A pre-built `amazon-ecs-local-container-endpoints` binary is (effectively) vendored with this extension, slight
modifications are made during the build process
to make it compile properly for supported operating systems and processor architectures. The modifications retain the
Apache License 2.0
license.
* The extension code is licensed under the [AGPL-3.0-or-later](LICENSE.txt)
Raw data
{
"_id": null,
"home_page": null,
"name": "localstack-extension-ecs-container-endpoints",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "localstack, localstack-extension, extension",
"author": null,
"author_email": "\"Mark S.\" <the@wondersmith.io>",
"download_url": "https://files.pythonhosted.org/packages/ff/1e/7a71c631f7756462908c9d39234df4b2b335518387d635859e2c52deb91c/localstack_extension_ecs_container_endpoints-0.1.3.tar.gz",
"platform": null,
"description": "LocalStack ECS Container Metadata Endpoints Extension\n===============================\n[](https://app.localstack.cloud/extensions/remote?url=git+https://github.com/the-wondersmith/localstack-extension-ecs-container-endpoints/#egg=localstack_extension_ecs_container_endpoints)\n\n[//]: # (https://github.com/awslabs/amazon-ecs-local-container-endpoints)\n\nAn extension enabling LocalStack to provide local versions of\nthe [ECS Task IAM Roles endpoint](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) and\nthe [ECS Task Metadata Endpoints](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html).\nGet the full [`amazon-ecs-local-container-endpoints`](https://github.com/awslabs/amazon-ecs-local-container-endpoints)\nfunctionality directly in LocalStack without needing to have additional containers running!\n\nThe `amazon-ecs-local-container-endpoints` API is served through both the hostname\n`http://metadata.ecs.localhost.localstack.cloud:4566` and\nthe [official \"well-known\" IP address](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v2.html#task-metadata-endpoint-v2-paths)\n`http://169.254.170.2`.\n\n## Install\n\nInstall the extension by running:\n\n```bash\nlocalstack extensions install localstack-extension-ecs-container-endpoints\n```\n\n## Usage\n\n### Configuration\n\nThe extension passes all environment variables prefixed with `ECS_LOCAL_CONTAINER_ENDPOINTS_` (*with a few\nexceptions)\nthrough to the\n`amazon-ecs-local-container-endpoints`\nprocess. See\nthe [upstream docs](https://github.com/awslabs/amazon-ecs-local-container-endpoints/blob/mainline/docs/configuration.md#environment-variables)\nfor information on configuring `amazon-ecs-local-container-endpoints`.\n\n> [!IMPORTANT]\n> Some environment variables are forcibly set to ensure the`amazon-ecs-local-container-endpoints` process\n> targets the running LocalStack instance. Specifically, the following environment variables will be ignored:\n> - IAM_ENDPOINT\n> - STS_ENDPOINT\n> - ECS_LOCAL_METADATA_PORT\n\n## Licensing\n\n* `amazon-ecs-local-container-endpoints` is licensed under\n the [Apache License 2.0](https://github.com/awslabs/amazon-ecs-local-container-endpoints/blob/mainline/LICENSE)\n* A pre-built `amazon-ecs-local-container-endpoints` binary is (effectively) vendored with this extension, slight\n modifications are made during the build process\n to make it compile properly for supported operating systems and processor architectures. The modifications retain the\n Apache License 2.0\n license.\n* The extension code is licensed under the [AGPL-3.0-or-later](LICENSE.txt)\n",
"bugtrack_url": null,
"license": "AGPL-3.0-or-later",
"summary": "LocalStack Extension: localstack-extension-ecs-container-endpoints",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/the-wondersmith/localstack-extension-ecs-container-endpoints"
},
"split_keywords": [
"localstack",
" localstack-extension",
" extension"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1b17a3a82941d624957e4b1178ce23c2189cf73eb3140cb3fd11b5f38f40828f",
"md5": "586b905bc5ef60d8f485b1f3dac18369",
"sha256": "f1f85723947980ea7c22100117456652aadb8c7edb346508d6c29838966d4654"
},
"downloads": -1,
"filename": "localstack_extension_ecs_container_endpoints-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "586b905bc5ef60d8f485b1f3dac18369",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 18193,
"upload_time": "2025-02-12T15:39:08",
"upload_time_iso_8601": "2025-02-12T15:39:08.758344Z",
"url": "https://files.pythonhosted.org/packages/1b/17/a3a82941d624957e4b1178ce23c2189cf73eb3140cb3fd11b5f38f40828f/localstack_extension_ecs_container_endpoints-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ff1e7a71c631f7756462908c9d39234df4b2b335518387d635859e2c52deb91c",
"md5": "230746af0c752df7274fbffa6f109afe",
"sha256": "975c070870bc2a91d40180304dc02abe253ac024aff1adc3b88b6ad530853c13"
},
"downloads": -1,
"filename": "localstack_extension_ecs_container_endpoints-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "230746af0c752df7274fbffa6f109afe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 21235,
"upload_time": "2025-02-12T15:39:10",
"upload_time_iso_8601": "2025-02-12T15:39:10.523900Z",
"url": "https://files.pythonhosted.org/packages/ff/1e/7a71c631f7756462908c9d39234df4b2b335518387d635859e2c52deb91c/localstack_extension_ecs_container_endpoints-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-12 15:39:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "the-wondersmith",
"github_project": "localstack-extension-ecs-container-endpoints",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "localstack-extension-ecs-container-endpoints"
}
JSON
