Esecuzione di un'applicazione dello spazio di lavoro

Schematics usa gli spazi di lavoro per distribuire e gestire le risorse negli account IBM Cloud®.

IBM Cloud Schematics consente di distribuire e gestire risorse in qualsiasi sede o regione di IBM Cloud a livello globale. L'area in cui si creano e si gestiscono gli spazi di lavoro e le azioni di Schematics è indipendente dall'area in cui sono distribuite o configurate le risorse cloud.

IBM Cloud Schematics esegue i tuoi lavori dalla regione Schematics che ospita lo spazio di lavoro e accede in remoto ai servizi per eseguire il provisioning delle risorse nelle regioni di destinazione determinate dai tuoi modelli Terraform. Le operazioni dello spazio di lavoro nelle regioni remote non sono influenzate dalla latenza di rete tra le aree di gestione e di destinazione.

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 su Schematics e il calendario delle deprecazioni.

Prima di iniziare

Creare una configurazione Terraform e salvarla in un repository su GitHub, GitLab o Bitbucket. È inoltre possibile caricare un file di archivio nastro (.tar) dalla workstation locale per fornire il 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’operazione di applicazione “ Schematics ” sul tuo workspace. Un'applicazione di lavoro fornisce, modifica o rimuove le risorse cloud che descrivi nel modello Terraform a cui punta il tuo spazio di lavoro. A seconda del tipo e del numero di risorse che si desidera configurare o modificare, il completamento di questa procedura potrebbe richiedere da pochi minuti a diverse ore. Durante questo periodo, non è possibile modificare il workspace. Una volta applicati tutti gli aggiornamenti, lo stato dei file rimane invariato per determinare quali risorse sono presenti nel tuo account IBM Cloud.

Esecuzione di un'applicazione dello spazio di lavoro utilizzando l'interfaccia utente

Accedere alla consoleIBM Cloud.
Fare clic sull'icona del menu > Automazione della piattaforma > Schematics > Terraform.
Cercare l'area di lavoro in una posizione specifica e fare clic sul nome dell'area di lavoro.
Fare clic su Applica piano per eseguire il provisioning delle risorse configurate.

Verifica dell'applicazione dello spazio di lavoro

Fai clic sul tuo workspace elencato nella consoleIBM Cloud per visualizzare i risultati del lavoro di applicazione dello spazio di lavoro.

Eseguire l'applicazione di uno spazio di lavoro utilizzando la CLI

Crea un file JSON sul tuo sistema per passare i parametri a Schematics per eseguire l'applicazione del workspace. 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 apply --id <Provide your workspace ID>

Applicare lo spazio di lavoro. Per ulteriori informazioni sull'indicatore dell'argomento apply, consultare il comando ibmcloud schematics apply.
```
ibmcloud schematics apply --id <workspace_id>
```
Verificare che l'applicazione dello spazio di lavoro sia stata eseguita correttamente. 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 della distribuzione dello spazio di lavoro

Eseguire il comando CLI per verificare che lo stato della distribuzione dello spazio di lavoro sia corretto.

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

In caso di esito positivo, restituisce i dettagli di aggiornamento di un'area di lavoro esistente.

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

Esegui la distribuzione 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.

Eseguire la distribuzione per lo spazio di lavoro esistente.

Esempio

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

Verificare che lo spazio di lavoro distribuisca l'elenco di tutti i lavori dello spazio di lavoro creati.
```
curl -X GET https://schematics.cloud.ibm.com/v1/workspaces -H "Authorization: <iam_access_token>"
```
vedi Gestione delle risorse cloud con Schematics per iniziare a creare, aggiornare o eliminare risorse cloud con Terraform.

Verifica della distribuzione dello spazio di lavoro

Verificare che lo spazio di lavoro sia distribuito correttamente come mostrato nell'output.

Output

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

Se lo spazio di lavoro viene applicato correttamente, restituisce l'ID attività lavoro eseguito sullo spazio di lavoro. Per ulteriori informazioni, vedi sezione sulla risoluzione dei problemi.

Esegui la distribuzione dello spazio di lavoro con 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 creare, aggiornare o eliminare risorse cloud con Terraform.

Passi successivi

Per gestire lo spazio di lavoro, fare riferimento a distribuzione dello spazio di lavoro, eliminazione spazio di lavoro e eliminazione spazio di lavoro.