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
+32-30Lines changed: 32 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -368,95 +368,95 @@ The service item’s details can be viewed in menu: **Services > My Services** i
368
368
369
369
## OpenTofu
370
370
371
-
OpenTofu is an open source infrastructure as code tool, which can be used to build, change, and version infrastructure. OpenTofu allows you to define infrastructure resources in human-readable configuration files that you can use to version, reuse, and share.
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
373
373
OpenTofu is built into {{ site.data.product.title_short }} so you do not need to install any additional components. The basic workflow to use OpenTofu in {{ site.data.product.title_short }} is as follows:
374
374
375
375
1. Enable the Embedded Terraform server role.
376
376
2. Add a source control repository that contains your templates.
377
377
3. Add credentials for your cloud providers.
378
-
4. Create a Service Catalog item with the desired Terraform template.
378
+
4. Create a Service Catalog item with the wanted Terraform template.
379
379
380
380
Use the following sections to learn more about OpenTofu and how to use these described workflows within {{ site.data.product.title_short }}.
381
381
382
382
### Enabling the Embedded Terraform Server Role
383
383
384
-
In {{ site.data.product.title_short }}, the Embedded Terraform Role is disabled by default. Enable this server role to utilize Terraform Automation Inside.
384
+
In {{ site.data.product.title_short }}, the Embedded Terraform server role is disabled by default. Enable this server role to use Terraform Automation Inside.
385
385
386
386
To enable the Embedded Terraform Server Role, use the following steps:
387
387
388
388
1. Browse to the settings menu, and click **Configuration** > **Settings**.
389
-
2. Select the desired server under **Zones**.
389
+
2. Select the wanted server under **Zones**.
390
390
3. Set the **Server Role** for **Embedded Terraform** to `On`.
391
391
392
392
### Verifying the Embedded Terraform worker state
393
393
394
-
Verify that the Embedded Terraform worker is started to utilize its features:
394
+
Verify that the Embedded Terraform worker is started to use its features:
395
395
396
-
1. Browse to the settings menu, then click **Configuration** > **Diagnostics** and click on the desired server.
396
+
1. Browse to the settings menu, then click **Configuration** > **Diagnostics** and click the server that you want to choose.
397
397
2. Click **Roles by Servers** tab.
398
398
399
-
A table of all workers and their current status appears from which you can confirm the state of your Embedded Terraform worker.
399
+
A table of all workers and their status appears from which you can confirm the state of your Embedded Terraform worker.
400
400
401
401
### Adding a Template Repository
402
402
403
-
To enable {{ site.data.product.title_short }} to discover and utilize your Terraform templates, add a repository to store and manage your templates.
403
+
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:
404
404
405
-
1. Browse to menu and click **Automation > Embedded Terraform > Repositories**.
405
+
1. Browse to the menu and click **Automation > Embedded Terraform > Repositories**.
406
406
407
407
2. Click **Configuration**, then  (**Add New Repository**).
408
408
409
409
3. Provide a Repository Name in the **Name** field.
410
410
411
411
4. Add a description for the repository in the **Description** field.
412
412
413
-
5. Add a **URL** or IP Address for the repository.
413
+
5. Add a **URL** or IP address for the repository.
414
414
415
-
6. Select the appropriate **SCM Credentials** from the dropdown menu.
415
+
6. Select the appropriate **SCM Credentials** from the drop-down menu.
416
416
417
417
7. Provide a branch name in the **SCM Branch** field.
418
418
419
419
8. Click **Save**.
420
420
421
-
Once you have synced a repository, the Terraform templates become available to {{ site.data.product.title_short }}.
421
+
When you sync a repository, the Terraform templates become available to {{ site.data.product.title_short }}.
422
422
423
423
### Refreshing Repositories
424
424
425
-
{{ site.data.product.title_short }} allows you to refresh a targeted Terraform templates or all repositories in your inventory to ensure that your templates are up to date.
425
+
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.
426
426
427
427
Use the following steps to refresh a targeted repository:
428
428
429
-
1. Browse to menu and click **Automation > Embedded Terraform > Repositories**.
429
+
1. Browse to the menu and click **Automation > Embedded Terraform > Repositories**.
430
430
431
-
2. Click on a repository.
431
+
2. Click a repository.
432
432
433
433
3. Click **Configuration**, then  (**Refresh this Repository**).
434
434
435
435
Alternately, you can refresh some or all of the repositories from the list view:
436
436
437
-
1. Browse to menu and click **Automation > Embedded Terraform > Repositories**.
437
+
1. Browse to the menu and click **Automation > Embedded Terraform > Repositories**.
438
438
439
439
2. Select the repositories that you want to refresh. Click **Check All** to select all repositories.
### Executing a Terraform Template from a Service Catalog
445
+
### Running a Terraform Template from a Service Catalog
446
446
447
-
You can execute a Terraform Template from {{ site.data.product.title_short }} by creating a Service Catalog item from a Terraform template.
447
+
You can run a Terraform Template from {{ site.data.product.title_short }} by creating a Service Catalog item from a Terraform template.
448
448
449
-
Use the following sections listed in order to execute a Terraform Template from a Service Catalog:
449
+
Use the following listed steps in each section to run the Terraform Template from a Service Catalog:
450
450
451
451
1. Create a catalog
452
452
2. Create a Terraform Service Catalog item
453
-
3.Execute the Terraform template
453
+
3.Run the Terraform template
454
454
455
455
#### Create a catalog
456
456
457
457
Use the following steps to create a catalog:
458
458
459
-
1. In the navigation bar click **Services** > **Catalogs and click Catalog Items**.
459
+
1. In the navigation bar, click **Services** > **Catalogs and click Catalog Items**.
460
460
461
461
2. Click **Configuration**, then click **Add a New Catalog**.
462
462
@@ -476,9 +476,9 @@ Use the following steps to create a Terraform Service Catalog item:
476
476
477
477
4. Click **Save**.
478
478
479
-
5. In the navigation nar click **Services** > **Catalogs** > **Catalog Items**.
479
+
5. In the navigation bar, click **Services** > **Catalogs** > **Catalog Items**.
480
480
481
-
6. Click **Configuration** > **Add a New Catalog Item* to create a new catalog item with the following details at minimum:
481
+
6. Click **Configuration** > **Add a New Catalog Item** to create a new catalog item with the following details at minimum:
482
482
483
483
- For **Catalog Item type**, select **Terraform Template**.
484
484
@@ -492,21 +492,23 @@ Use the following steps to create a Terraform Service Catalog item:
492
492
493
493
- In Provisioning, select the **Cloud Type** and then select the **credential** to connect to the cloud.
494
494
495
-
- In Provisioning, select the **Service Dialog** that you created previously. If you want enter additional information when running the task, **Service Dialog** must be selected. A dialog is required if **Display in Catalog** is chosen.
495
+
- In Provisioning, select the **Service Dialog** that you created previously. If you want to enter additional information when you run the task, **Service Dialog** must be selected. A dialog is required if **Display in Catalog** is chosen.
496
+
497
+
6. Click **Save**.
496
498
497
-
6. Click **Save**. The catalog item you created appears in the *All Service Catalog Items* list.
499
+
The catalog item that you created appears in the *All Service Catalog Items* list.
498
500
499
-
#### Execute the Terraform Template:
501
+
#### Run the Terraform Template:
500
502
501
-
Use the following steps to execute the Terraform Template.
503
+
Use the following steps to run the Terraform Template.
502
504
503
-
1. In the navigation bar click **Service** > **Catalogs** > **Service Catalogs** > **created catalog**.
505
+
1. In the navigation bar, click **Service** > **Catalogs** > **Service Catalogs** > **created catalog**.
504
506
505
507
2. Click **Order** for the catalog item.
506
508
507
-
3. Enter any variables requested and click **Submit**.
509
+
3. Enter any variables that are requested and click **Submit**.
508
510
509
511
{{ site.data.product.title_short }} takes you to the *Requests queue* page and displays the status of the job.
510
512
511
-
The service item details can be viewed by navigating to **Services** > **My Services in Infrastructure Automation**.
513
+
The service item details can be viewed when you navigate to **Services** > **My Services in Infrastructure Automation**.
0 commit comments