Arbeitsbereichsplan ausführen

Ein Workspace-Plan führt einen Terraform-Plan durch, um die Ressourcen unter IBM Cloud® zu ermitteln, die bei jedem nachfolgenden Workspace-Apply-Vorgang erstellt, geändert oder gelöscht werden. Führen Sie den Plan-Job „ Schematics “ für Ihren Arbeitsbereich aus. Sie können die Protokolle der Planzusammenfassung verwenden, um alle Ressourcenänderungen zu überprüfen, bevor die Vorlage angewendet wird.

IBM Cloud Schematics Ältere Versionen von Terraform werden nicht mehr unterstützt, und es wird Unterstützung für neuere Terraform-Versionen eingeführt. Weitere Informationen finden Sie unter Schematics Lebenszyklus der Veralterung in Terraform und Zeitplan für die Einstellung.

Vorbereitende Schritte

Stellen Sie sicher, dass der Endpunkt location und der Endpunkt url auf dieselbe Region verweisen, wenn Sie die Arbeitsbereiche und Aktionen für Schematics auflisten. Weitere Informationen zur Position und zum Endpunkt finden Sie unter Wo werden Ihre Informationen gespeichert?

  • Führen Sie einen Schematics-Planjob für Ihren Arbeitsbereich aus. Ein Planjob berechnet, welche Ressourcen bereitgestellt, geändert oder entfernt werden. Dieser Prozess kann einige Minuten dauern.

Während der Ausführung des Arbeitsbereichsplans können Sie Ihren Arbeitsbereich nicht bearbeiten.

Arbeitsbereichsplan über die Benutzerschnittstelle generieren

  1. Melden Sie sich bei der KonsoleIBM Cloud an.
  2. Klicken Sie auf das Hamburger-Symbol Menü > Plattformautomatisierung > Schematics > Terraform.
  3. Klicken Sie auf den Namen Ihres Arbeitsbereichs.
  4. Klicken Sie auf Plan generieren, um einen Plan für den Arbeitsbereich zu erstellen.

Arbeitsbereichsplan wird geprüft

  1. Klicken Sie auf Ihren Arbeitsbereich, der in der IBM Cloud-Konsole aufgelistet ist.
  2. Klicken Sie auf Jobs, um die Ergebnisse der Jobausführung anzuzeigen. Sie sind unter der Überschrift Generate Plan aufgeführt.
  3. Bei einem erfolgreichen Plan werden die Kosten für die vorgeschlagenen Änderungen durch Klicken auf die Schaltfläche Cost Estimate überprüft. Weitere Informationen finden Sie unter Schätzung der Infrastrukturkosten.

Arbeitsbereichsplan über die Befehlszeilenschnittstelle generieren

  1. Erstellen Sie auf Ihrem System eine JSON-Datei und planen Sie die Konfiguration Ihres Arbeitsbereichs. Weitere Informationen zu Konfigurationsoptionen finden Sie im Abschnitt zum Befehl ibmcloud schematics workspace new.

    Beispiel

    		{
    		"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"
    				}
    			]
    		}]
    	}
    

    Syntax

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

    Weitere Informationen zu Syntax-und Argumentflags finden Sie in der Beschreibung des Befehls ibmcloud schematics plan.

  2. Überprüfen Sie, ob Ihr Arbeitsbereichsplan angewendet wurde. Stellen Sie sicher, dass sich Ihr Arbeitsbereich im inaktiven Zustand befindet.

    ibmcloud schematics workspace list
    
  3. Siehe "Verwalten von Cloud-Ressourcen mit Schematics ", um Jobprotokolle anzuzeigen.

Ausführung des Arbeitsbereichsplans überprüfen

Führen Sie einen CLI-Befehl aus, um zu überprüfen, ob der Status des Arbeitsbereichsplans erfolgreich war.

```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
```

Bei erfolgreichem Plan werden die Aktualisierungsdetails eines vorhandenen Arbeitsbereichs zurückgegeben.

Weitere Informationen zu häufig gestellten Fragen finden Sie im Abschnitt Fehlerbehebung.

Arbeitsbereichsplan mit der API generieren

  1. Befolgen Sie die Schritte, um Ihren IAM Zugriffstoken abzurufen und authentifizieren Sie mit IBM Cloud Schematics mit der API.

  2. Plan für den vorhandenen Arbeitsbereich generieren.

    Beispiel

    	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"
    				}
    			]
    		}]
    	}
    
  3. Siehe "Verwalten von Cloud-Ressourcen mit Schematics ", um Cloud-Ressourcen mit Terraform zu erstellen, zu aktualisieren oder zu löschen.

Ausführung des Arbeitsbereichsplans überprüfen

Stellen Sie sicher, dass der Arbeitsbereichsplan erfolgreich mit der Liste der erstellten Arbeitsbereichsjobs aufgelistet wird.

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

Ausgabe

{
    "activityid": "3815ef757cd34030bc43191f7d7c6744"
}

Gibt bei Erfolg die Liste des Arbeitsbereichs zurück.

Weitere Informationen finden Sie unter FAQ und im Abschnitt Fehlerbehebung.

Arbeitsbereichsplan mit Terraform generieren

  1. Folgen Sie den Schritten in Terraform einrichten fürSchematics, um Ihren Arbeitsbereich mit Terraform zu erzeugen.

  2. Siehe "Cloud-Ressourcen verwalten" mit Schematics, um mit Terraform Cloud-Ressourcen zu erstellen, zu aktualisieren oder zu löschen.

Nächste Schritte

Die nächste Stufe der Arbeit mit dem Arbeitsbereich ist die Implementierung von Arbeitsbereichen.

Weitere Informationen finden Sie unter FAQ und im Abschnitt Fehlerbehebung.