Exécution d'un plan d'espace de travail

Un plan d'espace de travail exécute un plan Terraform afin de déterminer les ressources d' IBM Cloud® qui seront créées, modifiées ou supprimées lors de toute opération d'application ultérieure dans l'espace de travail. Exécutez la tâche de planification « Schematics » sur votre espace de travail. Vous pouvez utiliser les journaux récapitulatifs du plan pour vérifier les modifications apportées aux ressources avant l'application du modèle.

IBM Cloud Schematics abandonne les anciennes versions de Terraform et introduit la prise en charge des versions plus récentes de Terraform. Pour plus d'informations, consultez le cycle de dépréciation de Terraform sur Schematics ainsi que le calendrier de dépréciation.

Avant de commencer

Créez une configuration Terraform et stockez-la dans un référentiel GitHub, GitLab ou Bitbucket. Vous pouvez également télécharger une copie du référentiel en tant que tar (fichier d'archive de bande) depuis votre poste de travail local pour fournir votre modèle à IBM Cloud Schematics. Pour plus d'informations, consultez la ibmcloud schematics workspace upload commande et l'API permettant de télécharger un fichier « tar » dans votre espace de travail.
Assurez-vous de disposer des droits nécessaires pour créer un espace de travail.

Vérifiez que le noeud final location et url pointent vers la même région lorsque vous répertoriez les espaces de travail et les actions Schematics. Pour plus d'informations sur l'emplacement et le noeud final, voir Où sont stockées vos informations?

Exécutez un travail de plan Schematics sur votre espace de travail. Un travail de plan calcule les ressources qui sont mises à disposition, modifiées ou supprimées. Ce processus peut prendre quelques minutes.

Lors de l'exécution du plan d'espace de travail, vous ne pouvez pas éditer votre espace de travail.

Générer un plan d'espace de travail à l'aide de l'interface utilisateur

Connectez-vous à la consoleIBM Cloud
Cliquez sur l' Menu > Platform Automation > Schematics > Terraform.
Cliquez sur le nom de votre espace de travail.
Cliquez sur Générer un plan pour créer un plan pour l'espace de travail.

Vérification du plan d'espace de travail

Cliquez sur votre espace de travail répertorié dans la consoleIBM Cloud
Cliquez sur Travaux pour afficher les résultats d'exécution du travail. Elle est répertoriée sous l'en-tête Generate Plan
Dans le cas d'un plan réussi, le coût des modifications proposées est examiné en cliquant sur le bouton Cost Estimate. Pour plus d'informations, voir Estimation du coût de l'infrastructure.

Génération d'un plan d'espace de travail à l'aide de l'interface CLI

Créez un fichier JSON sur votre système et planifiez la configuration de votre espace de travail. Pour plus d'informations sur les options de configuration, voir la commande ibmcloud schematics workspace new.

Exemple

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

Syntaxe

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

Pour plus d'informations sur les indicateurs de syntaxe et d'arguments, voir la commande ibmcloud schematics plan.

Vérifiez que votre plan d'espace de travail est appliqué. Assurez-vous que votre espace de travail est à l'état « Inactif ».
```
ibmcloud schematics workspace list
```
Reportez-vous à la section Gestion des ressources Cloud avec Schematics pour afficher les journaux des tâches.

Vérification de l'exécution du plan de travail

Exécutez la commande de l'interface de ligne de commande pour vérifier que le statut du plan de l'espace de travail est réussi.

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

En cas de réussite, le plan renvoie les détails de mise à jour d'un espace de travail existant.

Pour plus d'informations sur la foire aux questions, voir la section relative au traitement des incidents.

Génération d'un plan d'espace de travail à l'aide de l'API

Suivez les étapes permettant d'extraire votre jeton d'accès IAM et de vous authentifier auprès d'IBM Cloud Schematics à l'aide de l'API.

Générez un plan pour l'espace de travail existant.

Exemple

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

Voir Gestion des ressources Cloud avec Schematics pour créer, mettre à jour ou supprimer des ressources Cloud avec Terraform.

Vérification de l'exécution du plan de travail

Vérifiez que le plan d'espace de travail est correctement répertorié avec la liste des travaux d'espace de travail qui ont été créés.

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

Sortie

{
    "activityid": "3815ef757cd34030bc43191f7d7c6744"
}

En cas de réussite, renvoie la liste de l'espace de travail.

Pour plus d'informations, voir la foire aux questions et la section de traitement des incidents.

Génération d'un plan d'espace de travail à l'aide de Terraform

Suivez les étapes présentées dans Configuration de Terraform pour Schematics pour créer votre espace de travail à l'aide de Terraform.
Voir Managing Cloud resources with Schematics pour commencer à créer, mettre à jour ou supprimer des ressources Cloud avec Terraform.

Etapes suivantes

L'étape suivante de l'utilisation de l'espace de travail consiste à déployer des espaces de travail.

Pour plus d'informations, voir la foire aux questions et la section de traitement des incidents.