Skip to main content

Administrar workspaces

Objetivo​

Os workspaces guardam conjuntos independentes de configurações da CLI, como região, tenant e credenciais de acesso. Com eles, você pode manter, por exemplo, um workspace para cada região e trocar de contexto com um único comando, sem reconfigurar a CLI. Neste guia, você vai aprender a criar, listar, alternar e excluir workspaces.

info

A CLI já vem com um workspace chamado default, que é usado até você ativar outro. Cada workspace fica em uma pasta mgc/<nome-do-workspace>/, com as próprias credenciais de acesso e configurações, dentro do diretório de configuração do seu sistema operacional:

  • Linux: ~/.config (ou $XDG_CONFIG_HOME, se estiver definida)
  • macOS: ~/Library/Application Support
  • Windows: %AppData%

Como esses arquivos ficam só na sua máquina, você precisa criar os workspaces de novo se instalar a CLI em outro computador.

Pré-requisitos​

Como fazer​

Criar um workspace​

Crie um workspace informando o nome dele:

mgc workspace create --name="meu-workspace"

Para partir das configurações de um workspace existente em vez de começar do zero, use a flag --copy com o nome do workspace de origem:

mgc workspace create \
    --name="meu-workspace" \
    --copy="default"

O workspace criado não fica ativo automaticamente. Para usá-lo, veja Alternar o workspace ativo.

Listar os workspaces​

Liste todos os workspaces da sua configuração local:

mgc workspace list

Consultar o workspace ativo​

Veja qual workspace está em uso no momento:

mgc workspace get

Alternar o workspace ativo​

Você pode definir o workspace ativo de duas formas:

  • Informando o nome do workspace:

    mgc workspace set --name="meu-workspace"

  • Selecionando o workspace em uma lista:

    mgc workspace select

A partir daí, todos os comandos usam as configurações desse workspace.

Excluir um workspace​

Exclua um workspace informando o nome dele:

mgc workspace delete --name="meu-workspace"

Perguntas frequentes​

Excluir um workspace remove recursos na Magalu Cloud?
Não. O workspace guarda apenas configurações locais da CLI. Excluí-lo não afeta nenhum recurso da sua conta.

Preciso fazer login de novo ao trocar de workspace?
Depende de como o workspace foi criado. Cada workspace guarda as próprias credenciais de acesso: se ele foi criado com --copy a partir de um workspace autenticado, já recebe essas credenciais; caso contrário, faça a autenticação depois de ativá-lo.

Próximos passos​