ResiLien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #12228 from hashicorp/paddy_update_gcp_project_docs 

provider/google: add migration notes for projects
This commit is contained in:
Paddy 2017-03-13 16:18:05 -07:00 committed by GitHub
parent 4d6242dfe0 c87d4101a8
commit 12b53a0767
2 changed files with 22 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
website/source/docs/providers/google/r/google_project.html.markdown
View File

@ -19,6 +19,24 @@ resource must have `roles/resourcemanager.projectCreator`. See the
[Access Control for Organizations Using IAM](https://cloud.google.com/resource-manager/docs/access-control-org) [Access Control for Organizations Using IAM](https://cloud.google.com/resource-manager/docs/access-control-org)
doc for more information. doc for more information.
Note that prior to 0.8.5, `google_project` functioned like a data source,
meaning any project referenced by it had to be created and managed outside
Terraform. As of 0.8.5, `google_project` functions like any other Terraform
resource, with Terraform creating and managing the project. To replicate the old
behavior, either:
* Use the project ID directly in whatever is referencing the project, using the
[google_project_iam_policy](/docs/providers/google/r/google_project_iam_policy.html)
to replace the old `policy_data` property.
* Use the [import](/docs/import/usage.html) functionality
to import your pre-existing project into Terraform, where it can be referenced and
used just like always, keeping in mind that Terraform will attempt to undo any changes
made outside Terraform.
~> It's important to note that any project resources that were added to your Terraform config
prior to 0.8.5 will continue to function as they always have, and will not be managed by
Terraform. Only newly added projects are affected.
## Example Usage ## Example Usage
```js ```js
@ -58,9 +76,6 @@ The following arguments are supported:
* `name` - (Optional) The display name of the project. * `name` - (Optional) The display name of the project.
This is required if you are creating a new project. This is required if you are creating a new project.
* `services` - (Optional) The services/APIs that are enabled for this project.
For a list of available services, run `gcloud beta service-management list`
* `skip_delete` - (Optional) If true, the Terraform resource can be deleted * `skip_delete` - (Optional) If true, the Terraform resource can be deleted
without deleting the Project via the Google API. without deleting the Project via the Google API.
@ -81,7 +96,7 @@ exported:
## ID Field ## ID Field
In previous versions of Terraform, `google_project` resources used an `id` field in In versions of Terraform prior to 0.8.5, `google_project` resources used an `id` field in
config files to specify the project ID. Unfortunately, due to limitations in Terraform, config files to specify the project ID. Unfortunately, due to limitations in Terraform,
this field always looked empty to Terraform. Terraform fell back on using the project this field always looked empty to Terraform. Terraform fell back on using the project
the Google Cloud provider is configured with. If you're using the `id` field in your the Google Cloud provider is configured with. If you're using the `id` field in your

3
website/source/docs/providers/google/r/google_project_iam_policy.html.markdown
View File

@ -11,6 +11,9 @@ description: |-
Allows creation and management of an IAM policy for an existing Google Cloud Allows creation and management of an IAM policy for an existing Google Cloud
Platform project. Platform project.
~> **Be careful!** You can accidentally lock yourself out of your project
using this resource. Proceed with caution.
## Example Usage ## Example Usage
```js ```js