Esecuzione di un piano dello spazio di lavoro

Un piano dell'area di lavoro esegue un piano Terraform per determinare le risorse IBM Cloud® che verranno create, modificate o eliminate in occasione di qualsiasi successiva operazione di applicazione dell'area di lavoro. Esegui il processo di pianificazione " Schematics " sul tuo spazio di lavoro. È possibile utilizzare i log di riepilogo del piano per verificare eventuali modifiche delle risorse prima che venga applicato il modello.

IBM Cloud Schematics sta rendendo obsolete le versioni precedenti di Terraform e introducendo il supporto per le versioni più recenti di Terraform. Per ulteriori informazioni, consultare il ciclo di vita della deprecazione di Terraform nell' Schematics e e il calendario delle deprecazioni.

Prima di iniziare

Creare una configurazione Terraform e salvarla in un repository su GitHub, GitLab o Bitbucket. Puoi anche caricare una copia del repository come un tar (file di archivio nastro) dalla tua workstation locale per fornire il tuo template a IBM Cloud Schematics. Per ulteriori informazioni, vedi il comando ibmcloud schematics workspace upload e vedi l'API upload a tar file to your workspace.
Assicurati di disporre dei permessi necessari per creare un'area di lavoro.

Assicurati che l'endpoint location e url puntino alla stessa regione quando elenchi le azioni e gli spazi di lavoro Schematics. Per ulteriori informazioni su ubicazione ed endpoint, vedi Dove sono memorizzate le tue informazioni?

Esegui un lavoro del piano Schematics rispetto allo spazio di lavoro. Un lavoro del piano calcola quali risorse vengono fornite, modificate o rimosse. Questo processo potrebbe richiedere alcuni minuti.

Durante l'esecuzione del piano del workspace, non è possibile modificare il proprio workspace.

Genera un piano dello spazio di lavoro utilizzando la UI

Accedere alla consoleIBM Cloud.
Fare clic sull'icona del menu > Automazione della piattaforma > Schematics > Terraform.
Fare clic sul nome dell'area di lavoro.
Fare clic su Genera piano per creare un piano per lo spazio di lavoro.

Verifica del piano dello spazio di lavoro

Fai clic sul tuo workspace elencato nella consoleIBM Cloud
Fare clic su Lavori per vedere i risultati di esecuzione del lavoro. Sono elencati sotto l'intestazione Generate Plan
In un piano riuscito, il costo per le modifiche proposte viene revisionato facendo clic sul pulsante Cost Estimate. Per ulteriori informazioni, vedi stima dei costi dell'infrastruttura.

Genera un piano dello spazio di lavoro utilizzando la CLI

Creare un file JSON sul proprio sistema e pianificare la configurazione dello spazio di lavoro. Per ulteriori informazioni sulle opzioni di configurazione, consultare il comando ibmcloud schematics workspace new.

Esempio

		{
		"name": "testwspace31jan",
		"type": [
			"terraform_v1.4"
		],
		"description": "terraform workspace",
		"location": "us-east",
		"tags": [
			"department:HR",
			"application:compensation",
			"environment:production"
		],
		"template_repo": {
			"url": "https://github.com/Anil-CM/newrepo"
		},
		"workspace_status": {
			"frozen": true
		},
		"template_data": [{
			"folder": ".",
			"type": "terraform_v1.4",
			"variablestore": [{
					"name": "sample_var",
					"secure": true,
					"value": "THIS IS IBM CLOUD TERRAFORM CLI DEMO",
					"description": "Description of sample_var"
				},
				{
					"name": "sleepy_time",
					"value": "15"
				}
			]
		}]
	}

Sintassi

	ibmcloud schematics plan --id WORKSPACE_ID [--output OUTPUT] [--var-file PATH_TO_VARIABLES_FILE] [--var-file PATH_TO_VARIABLES_FILE] []

Per ulteriori informazioni sugli indicatori di sintassi e di argomenti, consultare il comando ibmcloud schematics plan.

Verificare che il piano dello spazio di lavoro sia applicato. Assicurati che il tuo spazio di lavoro sia in uno stato Inattivo.
```
ibmcloud schematics workspace list
```
Fare riferimento a Gestione delle risorse cloud con Schematics per visualizzare i registri dei lavori.

Verifica dell'esecuzione del piano dello spazio di lavoro

Eseguire il comando CLI per controllare che lo stato del piano dello spazio di lavoro sia corretto.

```sh {: pre}
ibmcloud schematics workspace list
```    
```text {: screen}
Retrieving workspaces...
Name                                          ID                                                                       Description                                   Version             Status           Frozen
testwspace31jan                               us-east.workspace.testwspace31jan.a31438c6                               terraform workspace                           Terraform v1.0.11   INACTIVE         True

OK
```

Se il piano ha esito positivo restituisce i dettagli di aggiornamento di un'area di lavoro esistente.

Per ulteriori informazioni sulle FAQ, vedi sezione sulla risoluzione dei problemi.

Genera un piano dello spazio di lavoro utilizzando l'API

Segui i passi per recuperare il tuo token di accesso IAM e autenticarti con IBM Cloud Schematics utilizzando l'API.

Genera piano per lo spazio di lavoro esistente.

Esempio

	POST /v1/workspaces/{w_id}/plan HTTP/1.1
	Host: schematics.cloud.ibm.com
	Content-Type: application/json
	Authorization: <auth-token>
	Cache-Control: no-cache
	Postman-Token: bdc869fd-dc7c-06a6-5e99-4de6e3aa7dd9
	{
		"name": "testwspace31jan",
		"type": [
			"terraform_v1.4"
		],
		"description": "terraform workspace",
		"location": "us-east",
		"tags": [
			"department:HR",
			"application:compensation",
			"environment:production"
		],
		"template_repo": {
			"url": "<gitrepo-url>"
		},
		"workspace_status": {
			"frozen": true
		},
		"template_data": [{
			"folder": ".",
			"type": "terraform_v1.4",
			"variablestore": [{
					"name": "sample_var",
					"secure": true,
					"value": "THIS IS IBM CLOUD TERRAFORM CLI DEMO",
					"description": "Description of sample_var"
				},
				{
					"name": "sleepy_time",
					"value": "15"
				}
			]
		}]
	}

Vedere Gestione delle risorse cloud con Schematics per creare, aggiornare o eliminare risorse cloud con Terraform.

Verifica dell'esecuzione del piano dello spazio di lavoro

Verificare che il piano dello spazio di lavoro sia elencato correttamente con l'elenco dei lavori dello spazio di lavoro creati.

curl -X GET https://schematics.cloud.ibm.com/v1/workspaces -H "Authorization: <iam_access_token>"

Output

{
    "activityid": "3815ef757cd34030bc43191f7d7c6744"
}

In caso di esito positivo, restituisce l'elenco dello spazio di lavoro.

Per ulteriori informazioni, vedi FAQ e sezione per la risoluzione dei problemi.

Generazione di un piano dello spazio di lavoro utilizzando Terraform

Segui i passi in Configurazione di Terraform per Schematics per creare il tuo spazio di lavoro con Terraform.
Vedere Gestione delle risorse cloud con Schematics per iniziare a creare, aggiornare o eliminare risorse cloud con Terraform.

Passi successivi

La fase successiva dell'utilizzo dello spazio di lavoro è distribuzione degli spazi di lavoro.

Per ulteriori informazioni, vedi FAQ e sezione per la risoluzione dei problemi.