Anwenden eines Arbeitsbereichs ausführen

Schematics verwendet Arbeitsbereiche zum Bereitstellen und Verwalten von Ressourcen in IBM Cloud®-Konten.

IBM Cloud Schematics ermöglicht es Ihnen, Ressourcen an jedem beliebigen Standort oder in jeder beliebigen Region von „ IBM Cloud “ weltweit bereitzustellen und zu verwalten. Die Region, in der Sie Ihre „ Schematics “-Arbeitsbereiche und -Aktionen erstellen und bearbeiten, ist unabhängig von der Region, in der Ihre Cloud-Ressourcen bereitgestellt oder konfiguriert werden.

IBM Cloud Schematics führt Ihre Jobs aus der Schematics-Region aus, die den Arbeitsbereich hostet, und greift über Fernzugriff auf Services zu, um Ressourcen in den Zielregionen bereitzustellen, die durch Ihre Terraform-Vorlagen bestimmt werden. Arbeitsbereichsoperationen in fernen Regionen sind von der Netzlatenz zwischen den Management-und Zielregionen nicht betroffen.

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

Erstellen Sie eine Terraform-Konfiguration und speichern Sie die Konfiguration in einem GitHub-, GitLab- oder Bitbucket-Repository. Sie können auch eine Bandarchivdatei (.tar) von Ihrem lokalen Rechner hochladen, um Ihre Vorlage an IBM Cloud Schematics zu übermitteln. Weitere Informationen finden Sie unter dem ibmcloud schematics workspace upload Befehl sowie die API zum Hochladen einer „ tar “-Datei in Ihren Arbeitsbereich.
Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen zum Erstellen eines Arbeitsbereichs verfügen.

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 “-Apply-Job für Ihren Arbeitsbereich aus. Ein Anwendungsjob erstellt, ändert oder entfernt die Cloud-Ressourcen, die Sie in der Terraform-Vorlage beschreiben, auf die Ihr Arbeitsbereich verweist. Je nach Art und Anzahl der Ressourcen, die Sie bereitstellen oder ändern möchten, kann dieser Vorgang einige Minuten oder auch mehrere Stunden dauern. Während dieser Zeit können Sie Ihren Arbeitsbereich nicht bearbeiten. Nachdem alle Aktualisierungen übernommen wurden, bleibt der Status der Dateien erhalten, um festzustellen, welche Ressourcen in Ihrem „ IBM Cloud “-Konto vorhanden sind.

Anwenden eines Arbeitsbereichs über die Benutzerschnittstelle ausführen

Melden Sie sich bei der KonsoleIBM Cloud an.
Klicken Sie auf das Menü > Plattformautomatisierung > Schematics > Terraform.
Suchen Sie Ihren Arbeitsbereich an einem bestimmten Ort und klicken Sie auf den Namen Ihres Arbeitsbereichs.
Klicken Sie auf „Plan anwenden“, um die konfigurierten Ressourcen bereitzustellen.

Anwenden des Arbeitsbereichs überprüfen

Klicken Sie auf Ihren Arbeitsbereich, der in der IBM Cloud-Konsole aufgelistet ist, um die Ergebnisse des Arbeitsbereichsanwendungsjobs anzuzeigen.

Anwenden eines Arbeitsbereichs über die Befehlszeilenschnittstelle ausführen

Erstellen Sie eine JSON-Datei auf Ihrem System, um die Parameter an Schematics zu übergeben, damit der Arbeitsbereich angewendet wird. 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 apply --id <Provide your workspace ID>

Wenden Sie den Arbeitsbereich an. Weitere Informationen zum Flag "apply argument" finden Sie in der Beschreibung des Befehls ibmcloud schematics apply.
```
ibmcloud schematics apply --id <workspace_id>
```
Vergewissern Sie sich, dass Ihr Arbeitsbereich erfolgreich angewendet wurde. Stellen Sie sicher, dass sich Ihr Arbeitsbereich im inaktiven Zustand befindet.
```
   ibmcloud schematics workspace list
```
Siehe "Verwalten von Cloud-Ressourcen mit Schematics ", um Jobprotokolle anzuzeigen.

Implementierung des Arbeitsbereichs überprüfen

Führen Sie einen CLI-Befehl aus, um den Status der Arbeitsbereichsimplementierung zu überprüfen.

```text {: screen}
ibmcloud schematics apply --id us-east.workspace.testwspace01feb.b5e8fdaa
Do you really want to perform this action? [y/N]> Y

Activity ID   df51c0e61a020592d3403a05d08692d7

OK
```

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

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

Implementierung des Arbeitsbereichs mit der API durchführen

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

Führen Sie die Implementierung für den vorhandenen Arbeitsbereich durch.

Beispiel

	PUT /v1/workspaces/{w_id}/apply HTTP/1.1
	Host: schematics.cloud.ibm.com
	Content-Type: application/json
	Authorization: <auth-token>
	Cache-Control: no-cache
	Postman-Token: 77ef7f05-7290-0b60-781c-f8c147c78ed2
	{
		"name": "testworkspacejanATTest",
		"type": [
			"terraform_v1.4"
		],
		"description": "terraform workspace",
		"tags": [
			"test:bbbranch"
		],
		"template_repo": {
			"url": "https://github.com/srikar-git/tf_cloudless_sleepy/tree/v0.13"
		},
		"template_data": [{
			"folder": ".",
			"type": "terraform_v1.4",
		"variablestore": [
		{
		"value": "12",
		"name": "sleepy_time",
		"type": "string"
		}
	]
		}]
	}

Stellen Sie sicher, dass die Arbeitsbereichsimplementierung alle erstellten Arbeitsbereichjobs auflisten.
```
curl -X GET https://schematics.cloud.ibm.com/v1/workspaces -H "Authorization: <iam_access_token>"
```
siehe "Verwalten von Cloud-Ressourcen mit Schematics ", um mit Terraform Cloud-Ressourcen zu erstellen, zu aktualisieren oder zu löschen.

Implementierung des Arbeitsbereichs überprüfen

Überprüfen Sie, ob der Arbeitsbereich erfolgreich implementiert wurde, wie in der Ausgabe dargestellt.

Output

```text {: screen}
{
	"activityid": "a75d99109c80291faead70225b5409ee"
}
```

Bei einer erfolgreichen Anwendung des Arbeitsbereichs wird die Jobaktivitäts-ID zurückgegeben, die im Arbeitsbereich ausgeführt wurde. Weitere Informationen finden Sie im Abschnitt zur Fehlerbehebung.

Arbeitsbereichsbereitstellung mit Terraform ausführen

Folgen Sie den Schritten in Terraform einrichten fürSchematics, um Ihren Arbeitsbereich mit Terraform zu erzeugen.
Siehe "Verwalten von Cloud-Ressourcen mit Schematics ", um Cloud-Ressourcen mit Terraform zu erstellen, zu aktualisieren oder zu löschen.

Nächste Schritte

Informationen zum Verwalten Ihres Arbeitsbereichs finden Sie unter Arbeitsbereich implementieren, Arbeitsbereich löschen und Arbeitsbereich löschen.