{ "info": { "author": "", "author_email": "", "bugtrack_url": null, "classifiers": [], "description": "# Pulumi Terraform Provider\n\nThe Terraform resource provider for Pulumi lets you consume the outputs\ncontained in Terraform state files from your Pulumi programs. The package\nprovides a `RemoteStateReference` resource which acts like a native Pulumi\n[`StackReference`][stackreference].\n\nTo use this package, please [install the Pulumi CLI first][pulumicli].\n\n## Installing\n\n### Node.js (JavaScript/TypeScript)\n\nTo use from JavaScript or TypeScript in Node.js, install using either `npm`:\n\n $ npm install @pulumi/terraform\n\nor `yarn`:\n\n $ yarn add @pulumi/terraform\n \n### Python\n\nTo use from Python, install using `pip`:\n\n $ pip install pulumi-terraform\n\n## Concepts\n\nThe `@pulumi/terraform` package provides a resource named `RemoteStateReference`\nwhich is used to read outputs from a Terraform state file stored in one of the\nsupported Terraform remote state backends.\n\n## Examples\n\n### S3\n\nThe following program will read a Terraform state file stored in S3:\n\n```typescript\nimport * as tf from \"@pulumi/terraform\";\n\nconst remoteState = new tf.state.RemoteStateReference(\"s3state\", {\n backendType: \"s3\",\n bucket: \"pulumi-terraform-state-test\",\n key: \"test/terraform.tfstate\",\n region: \"us-west-2\"\n});\n\n// Use the getOutput function on the resource to access root outputs\nconst vpcId= remoteState.getOutput(\"vpc_id\");\n```\n\n### Local file\n\nThe following program will read a Terraform state file stored locally in the\nfilesystem:\n\n```typescript\nimport * as tf from \"@pulumi/terraform\";\n\nconst remotestate = new tf.state.RemoteStateReference(\"localstate\", {\n backendType: \"local\",\n path: path.join(__dirname, \"terraform.tfstate\"),\n});\n\n// Use the getOutput function on the resource to access root outputs\nconst vpcId= remoteState.getOutput(\"vpc_id\");\n```\n\n### Terraform Enterprise\n\nFor state stored in Terraform Enterprise, the authentication token must be set\nvia the Pulumi configuration system - for example, using:\n\n pulumi config set --secret terraformEnterpriseToken \n\nThe following program will read a Terraform state file stored in Terraform\nEnterprise, using the value of `terraformEnterpriseToken` from above:\n\n```typescript\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as tf from \"@pulumi/terraform\";\n\nconst config = new pulumi.Config();\n\nconst ref = new tf.state.RemoteStateReference(\"remote\", {\n backendType: \"remote\",\n organization: \"pulumi\",\n token: config.requireSecret(\"terraformEnterpriseToken\"),\n workspaces: {\n name: \"test-state-file\"\n }\n});\n\n// Use the getOutput function on the resource to access root outputs\nconst vpcId= remoteState.getOutput(\"vpc_id\");\n```\n\n[stackreference]: https://www.pulumi.com/docs/reference/organizing-stacks-projects/#inter-stack-dependencies\n[pulumicli]: https://pulumi.com/", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://pulumi.io", "keywords": "pulumi terraform", "license": "Apache-2.0", "maintainer": "", "maintainer_email": "", "name": "pulumi-terraform", "package_url": "https://pypi.org/project/pulumi-terraform/", "platform": "", "project_url": "https://pypi.org/project/pulumi-terraform/", "project_urls": { "Homepage": "https://pulumi.io", "Repository": "https://github.com/pulumi/pulumi-terraform" }, "release_url": "https://pypi.org/project/pulumi-terraform/1.1.0/", "requires_dist": null, "requires_python": "", "summary": "A Pulumi package for consuming Terraform Remote State resources.", "version": "1.1.0" }, "last_serial": 5930562, "releases": { "0.0.0": [ { "comment_text": "", "digests": { "md5": "fa803f071f3bfd8c9a3d7060cd7a19a8", "sha256": "4ee1718214a830a9e9ee6959cc700ac6e6cf852697c6852213fc7f021c31b87f" }, "downloads": -1, "filename": "pulumi_terraform-0.0.0.tar.gz", "has_sig": false, "md5_digest": "fa803f071f3bfd8c9a3d7060cd7a19a8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13986, "upload_time": "2019-09-14T11:40:17", "url": "https://files.pythonhosted.org/packages/de/0e/82f76e6c625b7a587ec30adca5abafecffec8fd5f1143ae39ffd41764d57/pulumi_terraform-0.0.0.tar.gz" } ], "0.18.4.dev1568410757": [ { "comment_text": "", "digests": { "md5": "578433cee881a9a9dc10a6cf69ce0385", "sha256": "34773aa893c51d783aed07ce089bc9ba819534c9ffe52d2eb662f326dc5add91" }, "downloads": -1, "filename": "pulumi_terraform-0.18.4.dev1568410757.tar.gz", "has_sig": false, "md5_digest": "578433cee881a9a9dc10a6cf69ce0385", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14022, "upload_time": "2019-09-13T22:38:20", "url": "https://files.pythonhosted.org/packages/a1/53/30d82ce3ba228cbb569b4e0c09f3e00339d34cb2395534f8a1149c8088bd/pulumi_terraform-0.18.4.dev1568410757.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "3cc91eba34286c9fd497cbe939ead152", "sha256": "fedd93f4f910b34df52d1d3a720de9239ab78921d3b027db261f3d2f7957bc79" }, "downloads": -1, "filename": "pulumi_terraform-1.0.0.tar.gz", "has_sig": false, "md5_digest": "3cc91eba34286c9fd497cbe939ead152", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11088, "upload_time": "2019-10-02T11:27:24", "url": "https://files.pythonhosted.org/packages/d4/1b/294e70f7b8edbc118b9cf06f5b4489b139e9931dec0c2a52f560f25ebff4/pulumi_terraform-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "2b0ff43e5b10fb9498fa18b4c2233cf0", "sha256": "a80d1274cd2b3a7e987673fec30006517a334e99688d5de6fd990b7b0a81a710" }, "downloads": -1, "filename": "pulumi_terraform-1.1.0.tar.gz", "has_sig": false, "md5_digest": "2b0ff43e5b10fb9498fa18b4c2233cf0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11083, "upload_time": "2019-10-04T22:57:34", "url": "https://files.pythonhosted.org/packages/46/59/dccd43938e48f10c0e775fe1ba8152ea6b80093a8271168d012b8ae2dc4d/pulumi_terraform-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "2b0ff43e5b10fb9498fa18b4c2233cf0", "sha256": "a80d1274cd2b3a7e987673fec30006517a334e99688d5de6fd990b7b0a81a710" }, "downloads": -1, "filename": "pulumi_terraform-1.1.0.tar.gz", "has_sig": false, "md5_digest": "2b0ff43e5b10fb9498fa18b4c2233cf0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11083, "upload_time": "2019-10-04T22:57:34", "url": "https://files.pythonhosted.org/packages/46/59/dccd43938e48f10c0e775fe1ba8152ea6b80093a8271168d012b8ae2dc4d/pulumi_terraform-1.1.0.tar.gz" } ] }