You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: managing_providers/_topics/automation_management_providers.md
+18-14Lines changed: 18 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -366,7 +366,7 @@ If you selected a service dialog to run when creating the button, {{ site.data.p
366
366
367
367
The service item’s details can be viewed in menu: **Services > My Services** in {{ site.data.product.title_short }}.
368
368
369
-
## OpenTofu
369
+
## Embedded Terraform (OpenTofu)
370
370
371
371
OpenTofu is an open source infrastructure as code tool, which can be used to build, change, and version the infrastructure. You can use OpenTofu to define infrastructure resources in human-readable configuration files that you can use to version, reuse, and share.
372
372
@@ -376,7 +376,7 @@ If you want to use the Embedded Terraform feature in {{ site.data.product.title_
376
376
377
377
## Importing OpenTofu image on an appliance
378
378
379
-
**Note**: Follow this section if you have {{ site.data.product.title_short }} that is deployed as a virtual machine appliance. These steps are not applicable to {{ site.data.product.title_short }} that is deployed as a containerized deployment (podified).
379
+
**Note**: Follow this section if you have {{ site.data.product.title_short }} that is deployed as a virtual appliance. These steps are not applicable to a containerized deployment (podified) of {{ site.data.product.title_short }}.
380
380
381
381
Use the following command to import the OpenTofu image on your appliance server.
Where `OpenTofu_image` is the name of your OpenTofu image.
388
388
389
389
390
-
You also need to set the docker image name in advanced settings page before enabling the server role. Navigate to the **Settings** > **Application Settings** in {{ site.data.product.title_short }} UI and set the value for `container_image` field.
390
+
You also need to set the docker image name in advanced settings before enabling the server role. Navigate to the **Settings** > **Application Settings** in {{ site.data.product.title_short }} UI and set the value for `workers/worker_base/opentofu_worker/container_image` field.
391
391
392
392
An example value of this field is `container_image: docker.io/manageiq/opentofu-runner:latest`.
393
393
@@ -397,17 +397,17 @@ The following sections show the usage of Embedded Terraform in {{ site.data.prod
397
397
398
398
1. Enable the Embedded Terraform server role.
399
399
2. Add a source control repository that contains your templates.
400
-
3. Add credentials for your cloud providers.
401
-
4. Create a Service Catalog item with the wanted Terraform template.
400
+
3. Add credentials to access the repository.
401
+
4. Create a Service Catalog item with the desired Terraform template.
402
402
403
403
### Enabling the Embedded Terraform Server Role
404
404
405
-
In {{ site.data.product.title_short }}, the Embedded Terraform server role is disabled by default. Enable this server role to use Terraform Automation Inside.
405
+
In {{ site.data.product.title_short }}, the Embedded Terraform server role is disabled by default. Enable this server role to use Embedded Terraform (OpenTofu).
406
406
407
407
To enable the Embedded Terraform Server Role, use the following steps:
408
408
409
409
1. Browse to the settings menu, and click **Configuration** > **Settings**.
410
-
2. Select the wanted server under **Zones**.
410
+
2. Select the desired server under **Zones**.
411
411
3. Set the **Server Role** for **Embedded Terraform** to `On`.
412
412
413
413
### Verifying the Embedded Terraform worker state
@@ -421,7 +421,11 @@ A table of all workers and their status appears from which you can confirm the s
421
421
422
422
### Adding a Template Repository
423
423
424
-
To enable {{ site.data.product.title_short }} to discover and use your Terraform templates, add a repository to store and manage your templates. Use the following steps to add a repository:
424
+
To enable {{ site.data.product.title_short }} to discover and use your Terraform templates, add a repository to store and manage your templates.
425
+
426
+
If your repository requires credentials for access, then you need to create SCM credentials. For more information about how to create SCM credentials, see [SCM credentials](../_topics/opentofu_credentials.md#scm).
427
+
428
+
Use the following steps to add a repository:
425
429
426
430
1. Browse to the menu and click **Automation > Embedded Terraform > Repositories**.
427
431
@@ -431,21 +435,21 @@ To enable {{ site.data.product.title_short }} to discover and use your Terraform
431
435
432
436
4. Add a description for the repository in the **Description** field.
433
437
434
-
5. Add a **URL**or IP address for the repository.
438
+
5. Add a **URL**and an optional port for the repository.
435
439
436
440
6. Select the appropriate **SCM Credentials** from the drop-down menu.
437
441
438
-
7. Provide a branch name in the **SCM Branch** field.
442
+
7. Provide a branch name in the **SCM Branch** field. This field is optional and default value is set to `master` branch.
439
443
440
444
8. Click **Save**.
441
445
442
-
When you sync a repository, the Terraform templates become available to {{ site.data.product.title_short }}.
446
+
When you save the repository, the Terraform templates are synced, and are available to {{ site.data.product.title_short }}.
443
447
444
448
### Refreshing Repositories
445
449
446
-
You can use {{ site.data.product.title_short }} to refresh targeted Terraform templates or all repositories in your inventory to make sure that your templates are up to date.
450
+
You can use {{ site.data.product.title_short }} to refresh specific Terraform repositories or all repositories in your inventory to make sure that your templates are up to date.
447
451
448
-
Use the following steps to refresh a targeted repository:
452
+
Use the following steps to refresh a specific repository:
449
453
450
454
1. Browse to the menu and click **Automation > Embedded Terraform > Repositories**.
451
455
@@ -531,5 +535,5 @@ Use the following steps to run the Terraform Template.
531
535
532
536
{{ site.data.product.title_short }} takes you to the *Requests queue* page and displays the status of the job.
533
537
534
-
The service item details can be viewed when you navigate to **Services** > **My Services in Infrastructure Automation**.
538
+
The service item details can be viewed when you navigate to **Services** > **My Services in {{ site.data.product.title_short }}**.
0 commit comments