Ejecución de una aplicación de espacio de trabajo

Schematics utiliza espacios de trabajo para desplegar y gestionar recursos en cuentas de IBM Cloud®.

IBM Cloud Schematics te permite implementar y gestionar recursos en cualquier ubicación o región de IBM Cloud a nivel mundial. La región en la que creas y gestionas tus espacios de trabajo y acciones de « Schematics » es independiente de la región en la que se implementan o configuran tus recursos en la nube.

IBM Cloud Schematics ejecuta los trabajos desde la región Schematics que aloja el espacio de trabajo y accede de forma remota a los servicios para suministrar recursos en las regiones de destino determinadas por las plantillas de Terraform. Las operaciones de espacio de trabajo en regiones remotas no se ven afectadas por la latencia de red entre las regiones de gestión y de destino.

IBM Cloud Schematics está dejando de dar soporte a las versiones antiguas 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 puedes subir un archivo de copia de seguridad en cinta (.tar) desde tu ordenador local para enviar tu 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?

Ejecuta una tarea de aplicación de « Schematics » en tu espacio de trabajo. Un trabajo de aplicación proporciona, modifica o elimina los recursos de la nube que usted describe en la plantilla de Terraform a la que apunta su espacio de trabajo. Dependiendo del tipo y del número de recursos que desee aprovisionar o modificar, este proceso puede tardar unos minutos o varias horas en completarse. Durante este tiempo, no puede editar el espacio de trabajo. Una vez aplicadas todas las actualizaciones, el estado de los archivos se mantiene para determinar qué recursos hay en tu cuenta de IBM Cloud.

Realizar una aplicación 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.
Busque su espacio de trabajo en una ubicación específica y haga clic en el nombre de su espacio de trabajo.
Haz clic en « Aplicar plan » para poner en marcha los recursos configurados.

Verificando aplicación de espacio de trabajo

Pulse el espacio de trabajo que se lista en la consola deIBM Cloud para ver los resultados del trabajo de aplicación del espacio de trabajo.

Realizar una aplicación de espacio de trabajo utilizando la CLI

Cree un archivo JSON en el sistema para pasar los parámetros a Schematics para ejecutar la aplicación del 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 apply --id <Provide your workspace ID>

Aplique el espacio de trabajo. Para obtener más información sobre el distintivo de aplicar argumento, consulte el mandato ibmcloud schematics apply.
```
ibmcloud schematics apply --id <workspace_id>
```
Verifique que la aplicación del espacio de trabajo se ha ejecutado correctamente. Asegúrate de que tu espacio de trabajo se encuentre en estado « Inactivo ».
```
   ibmcloud schematics workspace list
```
Consulte Gestión de recursos en la nube con Schematics para ver los registros de trabajo.

Verificación del despliegue del espacio de trabajo

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

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

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.

Realizar el despliegue del 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.

Realice el despliegue para el espacio de trabajo existente.

Ejemplo

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

Verifique que el despliegue del espacio de trabajo lista todos los trabajos del espacio de trabajo que se han creado.
```
curl -X GET https://schematics.cloud.ibm.com/v1/workspaces -H "Authorization: <iam_access_token>"
```
consulte Administrar recursos en la nube con Schematics para empezar a crear, actualizar o eliminar recursos en la nube con Terraform.

Verificación del despliegue del espacio de trabajo

Verifique que el espacio de trabajo se ha desplegado correctamente tal como se muestra en la salida.

Output

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

Si se aplica correctamente el espacio de trabajo, devuelve el ID de actividad de trabajo realizado en el espacio de trabajo. Para obtener más información, consulte la sección de resolución de problemas.

Realizar el despliegue del espacio de trabajo con 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 crear, actualizar o eliminar recursos en la nube con Terraform.

Próximos pasos

Para gestionar el espacio de trabajo, consulte Despliegue del espacio de trabajo, destrucción del espacio de trabajo y supresión del espacio de trabajo.