Exécution d'une application d'espace de travail

Schematics utilise des espaces de travail pour déployer et gérer des ressources dans des comptes IBM Cloud®.

IBM Cloud Schematics vous permet de déployer et de gérer des ressources dans n'importe quel site ou région d' IBM Cloud, partout dans le monde. La région dans laquelle vous créez et utilisez vos espaces de travail et vos actions Schematics s est indépendante de la région dans laquelle vos ressources Cloud sont déployées ou configurées.

IBM Cloud Schematics exécute vos travaux à partir de la région Schematics qui héberge l'espace de travail et accède à distance aux services pour mettre à disposition des ressources dans les régions cible déterminées par vos modèles Terraform. Les opérations de l'espace de travail dans les régions distantes ne sont pas affectées par le temps d'attente du réseau entre les régions de gestion et les régions cible.

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 vie de la 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 un fichier d'archive sur bande (.tar) depuis votre poste de travail local afin de 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?

Lancez une tâche d'application « Schematics » sur votre espace de travail. Une tâche d'application ajoute, modifie ou supprime les ressources Cloud que vous décrivez dans le modèle Terraform vers lequel pointe votre espace de travail. Selon le type et le nombre de ressources que vous souhaitez provisionner ou modifier, ce processus peut prendre quelques minutes, voire plusieurs heures. Pendant ce temps, vous ne pouvez pas éditer votre espace de travail. Une fois toutes les mises à jour appliquées, l'état des fichiers est conservé afin de déterminer quelles ressources sont présentes dans votre compte IBM Cloud.

Exécution d'une application d'espace de travail à l'aide de l'interface utilisateur

Connectez-vous à la consoleIBM Cloud
Cliquez sur l' Menu > Platform Automation > Schematics > Terraform.
Recherchez votre espace de travail dans un emplacement spécifique et cliquez sur le nom de votre espace de travail.
Cliquez sur « Appliquer le plan » pour provisionner les ressources configurées.

Vérification de l'application de l'espace

Cliquez sur votre espace de travail répertorié dans la consoleIBM Cloud pour afficher les résultats du travail d'application de l'espace de travail.

Effectuer une application d'espace de travail à l'aide de l'interface de ligne

Créez un fichier JSON sur votre système pour transmettre les paramètres à Schematics afin d'exécuter l'application de l'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 apply --id <Provide your workspace ID>

Appliquez l'espace de travail. Pour plus d'informations sur l'indicateur d'argument d'application, voir la commande ibmcloud schematics apply.
```
ibmcloud schematics apply --id <workspace_id>
```
Vérifiez que l'application de votre espace de travail a été exécutée avec succès. Assurez-vous que votre espace de travail est à l'état « Inactif ».
```
   ibmcloud schematics workspace list
```
Consultez la rubrique « Managing Cloud resources with Schematics » pour afficher les journaux des tâches.

Vérification du déploiement d'espace de travail

Exécutez la commande CLI pour vérifier le statut du déploiement de l'espace de travail.

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

Une fois le plan réussi, il 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.

Effectuer le déploiement de l'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.

Effectuez le déploiement pour l'espace de travail existant.

Exemple

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

Vérifiez que le déploiement de l'espace de travail répertorie tous les travaux d'espace de travail créés.
```
curl -X GET https://schematics.cloud.ibm.com/v1/workspaces -H "Authorization: <iam_access_token>"
```
voir Managing Cloud resources with Schematics pour commencer à créer, mettre à jour ou supprimer des ressources Cloud avec Terraform.

Vérification du déploiement d'espace de travail

Vérifiez que l'espace de travail est correctement déployé, comme indiqué dans la sortie.

Output

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

Lorsque l'application de l'espace de travail aboutit, elle renvoie l'ID d'activité de travail exécuté sur l'espace de travail. Pour plus d'informations, voir la section relative au traitement des incidents.

Effectuer le déploiement de l'espace de travail avec 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 Gestion des ressources Cloud avec Schematics pour créer, mettre à jour ou supprimer des ressources Cloud avec Terraform.

Etapes suivantes

Pour gérer votre espace de travail, voir Déploiement de l'espace de travail, destruction de l'espace de travail et suppression de l'espace de travail.