Ejecución de un plan de espacio de trabajo

Un plan de espacio de trabajo ejecuta un plan de Terraform para determinar los recursos IBM Cloud® que se crearán, modificarán o eliminarán en cualquier operación de aplicación posterior del espacio de trabajo. Ejecuta la tarea de planificación « Schematics » en tu espacio de trabajo. Puede utilizar los registros de resumen del plan para verificar cualquier cambio de recurso antes de aplicar la plantilla.

IBM Cloud Schematics está dejando de dar soporte a las versiones anteriores de Terraform e introduciendo compatibilidad con las versiones más recientes de Terraform. Para obtener más información, consulta el ciclo de vida de las funciones obsoletas de Terraform en Schematics y el calendario de obsolescencia.

Antes de empezar

Cree una configuración de Terraform y guarde la configuración en un repositorio GitHub, GitLab o Bitbucket. También puede cargar una copia del repositorio como tar (archivo de archivado de cinta) desde la estación de trabajo local para proporcionar la plantilla a IBM Cloud Schematics. Para obtener más información, consulta el ibmcloud schematics workspace upload comando y la API para subir un archivo « tar » a tu espacio de trabajo.
Asegúrate de que tienes los permisos necesarios para crear un espacio de trabajo.

Asegúrese de que location y el punto final url apunten a la misma región cuando liste los espacios de trabajo y las acciones de Schematics. Para obtener más información sobre la ubicación y el punto final, consulte ¿Dónde está almacenada la información?

Ejecute un trabajo de plan Schematics en el espacio de trabajo. Un trabajo de plan calcula qué recursos se suministran, modifican o eliminan. Este proceso puede tardar unos minutos.

Durante la ejecución del plan de espacio de trabajo, no puede editar el espacio de trabajo.

Generar un plan de espacio de trabajo utilizando la interfaz de usuario

Inicie sesión en la consolaIBM Cloud.
Haga clic en el icono de menú > Automatización de plataformas > Schematics > Terraform.
Haz clic en el nombre de tu espacio de trabajo.
Pulse Generar plan para crear un plan para el espacio de trabajo.

Verificando plan de espacio de trabajo

Pulse el espacio de trabajo que aparece en la consola deIBM Cloud
Pulse Trabajos para ver los resultados de la ejecución del trabajo. Se listan bajo la cabecera Generate Plan
En un plan satisfactorio, el coste de los cambios propuestos se revisa pulsando el botón Cost Estimate. Para obtener más información, consulte Estimación de costes de infraestructura.

Generar un plan de espacio de trabajo utilizando la CLI

Crea un archivo JSON en tu sistema y planifica la configuración de tu espacio de trabajo. Para obtener más información sobre las opciones de configuración, consulte el mandato ibmcloud schematics workspace new.

Ejemplo

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

Sintaxis

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

Para obtener más información sobre los distintivos de sintaxis y argumentos, consulte el mandato ibmcloud schematics plan.

Verifique que se ha aplicado el plan de espacio de trabajo. Asegúrate de que tu espacio de trabajo se encuentre en estado « Inactivo ».
```
ibmcloud schematics workspace list
```
Consulte Administrar recursos en la nube con Schematics para ver los registros de trabajo.

Verificación de ejecución de plan de espacio de trabajo

Ejecute el mandato de CLI para comprobar que el estado del plan de espacio de trabajo es satisfactorio.

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

Si el plan es satisfactorio, devuelve los detalles de actualización de un espacio de trabajo existente.

Para obtener más información sobre las preguntas frecuentes, consulte la sección de resolución de problemas.

Generar un plan de espacio de trabajo utilizando la API

Siga los pasos para recuperar la señal de acceso de IAM y autenticarse en IBM Cloud Schematics utilizando la API.

Generar plan para el espacio de trabajo existente.

Ejemplo

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

Consulte Administrar recursos en la nube con Schematics para crear, actualizar o eliminar recursos en la nube con Terraform.

Verificación de ejecución de plan de espacio de trabajo

Verifique que el plan de espacio de trabajo se lista correctamente con la lista de trabajos de espacio de trabajo que se han creado.

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

Salida

{
    "activityid": "3815ef757cd34030bc43191f7d7c6744"
}

Si es satisfactorio, devuelve la lista del espacio de trabajo.

Para obtener más información, consulte Preguntas más frecuentes y la sección de resolución de problemas.

Generación de un plan de espacio de trabajo utilizando Terraform

Siga los pasos de Configuración de Terraform para Schematics para crear el espacio de trabajo con Terraform.
Consulte Administrar recursos en la nube con Schematics para empezar a crear, actualizar o eliminar recursos en la nube con Terraform.

Próximos pasos

La siguiente etapa del trabajo con el espacio de trabajo es desplegar espacios de trabajo.

Para obtener más información, consulte Preguntas más frecuentes y la sección de resolución de problemas.