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
- Crie uma configuração do Terraform e armazene a configuração em um repositório
GitHub
,GitLab
ouBitbucket
. Também é possível fazer upload de uma cópia do repositório como umtar
(archive de fita) de sua estação de trabalho local para fornecer seu modelo para o IBM Cloud Schematics. Para mais informações, consulte oibmcloud schematics workspace upload
comando e veja o upload de umtar
arquivo para sua API de área de trabalho. - Certifique-se de que você tem as permissões 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 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
- Faça login no consoleIBM Cloud.
- Clique no ícone
Menu > Platform Automation > Schematics > Terraform.
- Clique no nome do seu espaço de trabalho.
- Clique em Gerar Plano para criar um plano para a área de trabalho
Verificando o plano da área de trabalho
- Clique em sua área de trabalho que está listada no console do IBM Cloud
- Clique em Tarefas para ver os resultados de execução da tarefa Ele está listado sob o título
Generate Plan
- 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
-
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
. -
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
-
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
-
Siga as etapas para recuperar seu token de acesso do IAM e autenticar com o IBM Cloud Schematics usando a API.
-
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" } ] }] }
-
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
-
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 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.