Adding sections for new terraform config #1147
Conversation
EMcWhinn
added
documentation
| . From the navigation panel, select {MenuAEProjects}. | ||
| . On the *Projects* page, click btn:[Create project] to start the *Create Project* window. | ||
| ** Enter the appropriate details according to the steps in xref:proc-controller-adding-a-project[Adding a new project]. | ||
| ** Use the configuration files at link:https://github.com/hakbailey/terraform-aap-demo[terraform-aap-demo]. |
There was a problem hiding this comment.
We probably don't want to link to my personal repo here. Which configuration files are being referenced?
There was a problem hiding this comment.
Removed this sub-step.
| + | ||
| //The current 2.5 test environment does not have the following option yet: | ||
| . Select an *Execution Environment* that has a Terraform binary. | ||
| This is required for the inventory plugin to run the Terraform commands that read inventory data from the Terraform state file. |
There was a problem hiding this comment.
We could optionally link here to the example terraform EE configuration repo: https://github.com/ansible-cloud/terraform_ee
| .Additional resources | ||
| For more information, see the link:https://github.com/ansible-cloud/terraform_ee[Terraform EE] readme that has an example {ExecEnvShort} configuration with a Terraform binary. | ||
|
|
||
| == Terraform provider for {PlatformNameShort} |
There was a problem hiding this comment.
@hakbailey I've added a sub-section here for the Terraform provider, does this work? And are there steps I can grab from somewhere to document here?
There was a problem hiding this comment.
I think rather than providing steps here we likely just want to say something along the lines of "Inventories and hosts can also be created within Terraform configuration using the Terraform provider for AAP." and then link to the provider documentation. Ultimately that will live in the Terraform Provider registry but since we haven't published the initial release yet, we may need to just link to the Github repo. @gravesm thoughts or anything to add?
There was a problem hiding this comment.
Got it, thanks @hakbailey.
There was a problem hiding this comment.
I believe we should have docs we can link to on the Hashi registry in ~2 weeks. I'm not sure what the timing looks like for docs publishing for AAP. If possible, I think pausing this for a couple weeks until we have the official provider docs published that we can link to would be best.
There was a problem hiding this comment.
Thanks @gravesm, docs hardening is June 4th - June 18th (2 wks) with publishing on June 18th, so ~2 weeks to confirm the docs here should be fine.
There was a problem hiding this comment.
Provider has been released! Here's the official docs link: https://registry.terraform.io/providers/ansible/aap/latest/docs
* Fixed icon size (ansible#1147) * Fixed icon size Changed size to 10,25 https://issues.redhat.com/browse/AAP-13667 * Fixed icon size Removed git artifact Duplicated content and unscaled icons need fixing https://issues.redhat.com/browse/AAP-13667
Create product docs for terraform-provider-aap https://issues.redhat.com/browse/ACA-1187 Affects `controller-user-guide`
| Inventories created this way are managed by Terraform and you must not edit them in {PlatformNameShort} as it can introduce drift to the Terraform deployment. | ||
|
|
||
| You can create inventories and hosts within the Terraform configuration by using the Terraform provider for {PlatformNameShort}. | ||
| For more information, see the link:https://registry.terraform.io/providers/ansible/aap/latest/docs[AAP Provider] section of the Terraform documentation. |
There was a problem hiding this comment.
Great thanks @hakbailey, I've added the info. Does it all look good to you?
Create product docs for terraform-provider-aap
https://issues.redhat.com/browse/ACA-1187
Affects
controller-user-guide