Executando uma aplicação de área de trabalho

Schematics usa áreas de trabalho para implementar e gerenciar recursos em contas do IBM Cloud®.

IBM Cloud Schematics permite que você implante e gerencie recursos em qualquer local ou região do IBM Cloud em todo o mundo. A região na qual você cria e trabalha com seus espaços de trabalho e ações do Schematics é independente da região na qual seus recursos na nuvem estão implantados ou configurados.

IBM Cloud Schematics executa suas tarefas a partir da região Schematics que hospeda a área de trabalho e acessa remotamente serviços para provisionar recursos nas regiões de destino determinadas por seus modelos do Terraform. As operações da área de trabalho em regiões remotas não são afetas pela latência de redes entre as regiões de gerenciamento e de destino

IBM Cloud Schematics está descontinuando o uso das versões mais antigas do Terraform e introduzindo suporte para a versão mais recente do Terraform. Para obter mais informações, consulte o ciclo de vida de descontinuação do Terraform no Schematics e o Cronograma de descontinuação.

Antes de Iniciar

Crie uma configuração do Terraform e armazene a configuração em um repositório GitHub, GitLab ou Bitbucket. Você também pode enviar um arquivo de arquivamento em fita (.tar) da sua estação de trabalho local para disponibilizar seu modelo para IBM Cloud Schematics. Para obter mais informações, consulte o ibmcloud schematics workspace upload e consulte a API para enviar um arquivo tar para sua área de trabalho.
Certifique-se de que possui as permissões necessárias para criar um espaço de trabalho.

Assegure-se de que o terminal location e o terminal url estejam apontando para a mesma região ao listar as áreas de trabalho e ações do Schematics. Para obter mais informações sobre local e terminal, consulte Onde suas informações estão armazenadas?

Execute uma tarefa de aplicação do Schematics no seu espaço de trabalho. Um trabalho de aplicação provisiona, modifica ou remove os recursos da nuvem que você descreve no modelo do Terraform para o qual seu espaço de trabalho aponta. Dependendo do tipo e do número de recursos que você deseja provisionar ou modificar, esse processo pode levar alguns minutos ou horas para ser concluído. Durante esse tempo, não é possível editar sua área de trabalho Depois que todas as atualizações forem aplicadas, o estado dos arquivos permanece o mesmo para determinar quais recursos existem na sua conta do IBM Cloud.

Executar uma aplicação de área de trabalho usando a UI

Faça login no consoleIBM Cloud.
Clique no ícone Menu > Platform Automation > Schematics > Terraform.
Procure seu espaço de trabalho em um local específico e clique no nome do espaço de trabalho.
Clique em “Aplicar plano” para provisionar os recursos configurados.

Verificando aplicação da área de trabalho

Clique em sua área de trabalho que está listada no IBM Cloud console para visualizar os resultados da tarefa de aplicação da área de trabalho.

Executar uma aplicação de área de trabalho usando a CLI

Crie um arquivo JSON no sistema para transmitir os parâmetros para Schematics para executar a aplicação da área de trabalho. Para obter mais informações sobre as opções de configuração, consulte o comando ibmcloud schematics workspace new

Exemplo

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

Sintaxe

ibmcloud schematics apply --id <Provide your workspace ID>

Aplique a área de trabalho Para obter mais informações sobre o sinalizador do argumento de aplicação, consulte o comando ibmcloud schematics apply
```
ibmcloud schematics apply --id <workspace_id>
```
Verifique se a sua aplicação de área de trabalho foi executada com êxito Certifique-se de que seu espaço de trabalho esteja no estado “Inativo ”.
```
   ibmcloud schematics workspace list
```
Consulte Gerenciando recursos de nuvem com Schematics para visualizar os registros de trabalho.

Verificando a implementação da área de trabalho.

Execute o comando da CLI para verificar se o status da implementação da área de trabalho foi bem-sucedido.

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

Em um plano bem-sucedido, ele retorna os detalhes de atualização de uma área de trabalho existente

Para obter mais informações sobre FAQ, consulte seção de resolução de problemas.

Execute a implementação da área de trabalho utilizando a API

Siga as etapas para recuperar seu token de acesso do IAM e autenticar com o IBM Cloud Schematics usando a API.

Execute a implementação para a área de trabalho existente

Exemplo

	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 se a implementação da área de trabalho lista todas as tarefas da área de trabalho criadas.
```
curl -X GET https://schematics.cloud.ibm.com/v1/workspaces -H "Authorization: <iam_access_token>"
```
consulte Gerenciando recursos de nuvem com Schematics para começar a criar, atualizar ou excluir recursos de nuvem com o Terraform.

Verificando a implementação da área de trabalho.

Verifique se a área de trabalho foi implementada com êxito conforme mostrado na saída.

Output

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

Na aplicação bem-sucedida da área de trabalho, ele retorna o ID de atividade de tarefa executado na área de trabalho Para obter mais informações, consulte a seção de resolução de problemas

Execute a implementação da área de trabalho no Terraform

Siga as etapas em Configurando o Terraform para Schematics para criar sua área de trabalho com o Terraform.
Consulte Gerenciando recursos de nuvem com Schematics para criar, atualizar ou excluir recursos de nuvem com o Terraform.

Próximas etapas

Para gerenciar sua área de trabalho, consulte Implementando área de trabalho, destruindo área de trabalho e excluindo área de trabalho.