IBM Cloud Docs
Executando um plano de área de trabalho

Executando um plano de área de trabalho

Um plano de área de trabalho executa um plano do Terraform para determinar os recursos do IBM Cloud® que são criados, modificados ou excluídos em qualquer operação de aplicação de área de trabalho subsequente. Execute a tarefa do plano Schematics em sua área de trabalho. É possível usar os logs de sumarização do plano para verificar quaisquer mudanças de recurso antes que o modelo seja aplicado

O IBM Cloud Schematics descontinua a versão mais antiga do Terraform. Para obter mais informações, consulte Descontinuando a versão mais antiga do processo do Terraform no IBM Cloud Schematics.

IBM Cloud Schematics descontinua a criação da área de trabalho usando o modelo IBM Cloud Provider Plug-in for Terraform v1.2, v1.3 da 2nd semana de abril de 2024.

Antes de Iniciar

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 do plano Schematics em sua área de trabalho. Uma tarefa de plano calcula quais recursos são fornecidos, modificados ou removidos. Esse processo pode demorar alguns minutos.

Durante a execução do plano da área de trabalho, não é possível editar sua área de trabalho

Gerar um plano de área de trabalho usando a IU

  1. Faça login no consoleIBM Cloud.
  2. Clique no ícone de hambúrguer Menu > Platform Automation > Schematics > Terraform.
  3. Clique no nome do seu espaço de trabalho.
  4. Clique em Gerar Plano para criar um plano para a área de trabalho

Verificando o plano da área de trabalho

  1. Clique em sua área de trabalho que está listada no console do IBM Cloud
  2. Clique em Tarefas para ver os resultados de execução da tarefa Ele está listado sob o título Generate Plan
  3. Em um plano bem-sucedido, o custo das alterações propostas é revisado clicando no botão Cost Estimate. Para obter mais informações, consulte Estimação do custo de infraestrutura

Gerar um plano de área de trabalho usando a CLI

  1. Crie um arquivo JSON no seu sistema e planeje a configuração do seu espaço 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 plan --id WORKSPACE_ID [--output OUTPUT] [--var-file PATH_TO_VARIABLES_FILE] [--var-file PATH_TO_VARIABLES_FILE] []
    

    Para obter mais informações sobre sinalizações de sintaxe e argumentos, consulte o comando ibmcloud schematics plan.

  2. Verifique se o seu plano de área de trabalho foi aplicado Certifique-se de que seu espaço de trabalho esteja em um estado inativo.

    ibmcloud schematics workspace list
    
  3. Consulte Gerenciar recursos da nuvem com Schematics para visualizar os registros de trabalho.

Verificando execução do plano da área de trabalho

Execute o comando da CLI para verificar se o status do plano da área de trabalho foi bem-sucedido

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

No plano bem-sucedido 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.

Gerar um plano de área de trabalho usando a API

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

  2. Gerar plano para a área de trabalho existente.

    Exemplo

    
    	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"
    				}
    			]
    		}]
    	}
    
    
  3. Consulte Gerenciando recursos de nuvem com Schematics para criar, atualizar ou excluir recursos de nuvem com o Terraform.

Verificando execução do plano da área de trabalho

Verifique se o plano da área de trabalho foi listado com êxito com a lista de tarefas da área de trabalho que foram criadas

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

Saída

{
    "activityid": "3815ef757cd34030bc43191f7d7c6744"
}

Quando bem-sucedido, retorna a lista da área de trabalho.

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

Gerando um plano de área de trabalho usando Terraform

  1. Siga as etapas em Configurando o Terraform para Schematics para criar sua área de trabalho com o Terraform.

  2. Consulte Gerenciando recursos de nuvem com Schematics para começar a criar, atualizar ou excluir recursos de nuvem com o Terraform.

Próximas etapas

O próximo estágio de trabalho com a área de trabalho é áreas de trabalho de implementação

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