Skip to content

Aap 51980: Clarifications for migrating from community to TFE #4166

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Sep 4, 2025
+12 −11
Merged

Aap 51980: Clarifications for migrating from community to TFE #4166

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
fe24770
Upate wording for better accuracy in COmmunity Migration section
jonquilwilliams Aug 28, 2025
e90a893
Fixed links
jonquilwilliams Aug 28, 2025
05171ef
more edits
jonquilwilliams Aug 28, 2025
0daf682
Doing what git told me to
jonquilwilliams Sep 4, 2025
d10b2cd
Removed note
jonquilwilliams Sep 4, 2025
31e383f
Fixed punctuation
jonquilwilliams Sep 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions ...tream/assemblies/terraform-aap/assembly-terraform-migrating-from-community.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,11 @@

[id="terraform-migrating-from-community-terraform"]

= Migrating from the community version of Terraform
= Migrating from {TerraformCommunityName}

If you are using {TerraformCommunityName} Edition (TCE) and want to use {PlatformNameShort}, you must migrate to {TerraformEnterpriseShortName} (TFE) or {TerraformCloudShortName}.
If you want to use {PlatformNameShort} with {TerraformEnterpriseShortName} (TFE) or {TerraformCloudShortName} and you are currently using {TerraformCommunityName} (TCE), you must:

* Migrate to TFE or {TerraformCloudShortName}.
* Update {PlatformNameShort} configurations to work with TFE or {TerraformCloudShortName}.

include::terraform-aap/proc-terraform-migrating-from-community.adoc[leveloffset=+1]
2 changes: 1 addition & 1 deletion downstream/attributes/attributes.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@
:TerraformEnterpriseFullName: IBM HashiCorp Terraform
:TerraformEnterpriseShortName: Terraform Enterprise
:TerraformCloudShortName: HCP Terraform
:TerraformCommunityName: Terraform Community
:TerraformCommunityName: Terraform Community Edition
:Terraform: Terraform

// Ansible development tools
Expand Down
14 changes: 6 additions & 8 deletions downstream/modules/terraform-aap/proc-terraform-migrating-from-community.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

[id="terraform-migrating-from-community"]

= Migrating from the community version of {Terraform}
= Migrating from the community edition

When you migrate from {TerraformCommunityName} Edition (TCE) to {TerraformEnterpriseShortName} (TFE) or {TerraformCloudShortName}, you are not migrating the collection itself. Instead, you are adapting your existing usage to work with {TerraformEnterpriseShortName} or {TerraformCloudShortName}. After you migrate, you will be able to leverage {PlatformNameShort}.
When you migrate from TCE to TFE or {TerraformCloudShortName}, you are not migrating the collection itself. Instead, you are adapting your existing TCE usage to work with TFE or {TerraformCloudShortName}. After you migrate, you must update the {PlatformNameShort} credentials, execution environment, and job templates.

[NOTE]
====
Expand Down Expand Up @@ -39,13 +39,11 @@ You can add the workspace to your playbook to scale your workspace utilization.
====
+
. From the {PlatformNameShort} user interface:
.. Create a credential.
.. Build an {ExecEnvShort}.
.. Create and launch a job template.
.. link:https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.5/html/getting_started_with_terraform_and_ansible_automation_platform/terraform-integrating-from-aap#terraform-creating-credential[Create a credential].
.. link:https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.5/html/getting_started_with_terraform_and_ansible_automation_platform/terraform-integrating-from-aap#terraform-building-execution-environment[Build an {ExecEnvShort}].
.. link:https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.5/html/getting_started_with_terraform_and_ansible_automation_platform/terraform-integrating-from-aap#terraform-creating-launching-job-template[Create and launch a job template].

. After the migration is completed and verified, you can run the additional modules and plugins from the collection in your {ExecEnvShort} listed under **Additional resources** below.

.Additional resources
. (Optional) After the migration is completed and verified, you can run the additional modules and plugins from the collection in your {ExecEnvShort}:

* link:https://console.redhat.com/ansible/automation-hub/repo/published/cloud/terraform/content/module/plan_stash/[Plan Stash module]
* link:https://console.redhat.com/ansible/automation-hub/repo/published/cloud/terraform/content/module/terraform/[{Terraform} module]
Expand Down