IBM Cloud Docs
Integração de sua arquitetura implantável usando uma extensão do Visual Studio Code

Integração de sua arquitetura implantável usando uma extensão do Visual Studio Code

Você pode integrar sua arquitetura implantável usando a extensão IBM Cloud Extensão Visual Studio Code Construtor de Arquitetura Implantável. O uso da extensão gera automaticamente os materiais necessários e pode evitar ou minimizar problemas em que uma configuração separada é feita cada vez que o usuário executa a validação por meio do catálogo. A extensão ajuda você a integrar facilmente sua arquitetura implementável ao seu catálogo privado e a um projeto.

Antes de Iniciar

Antes de poder integrar sua arquitetura implementável, certifique-se de concluir os seguintes pré-requisitos.

  • Baixar Visual Studio Code
  • Verifique se você está usando uma conta Pré-paga ou de Assinatura. Consulte Visualizando seu tipo de conta para obter mais detalhes.
  • Verifique se você tem o acesso necessário para trabalhar com catálogos privados e arquiteturas implementáveis.
    • Função de gerente no serviço IBM Cloud Schematics
    • Função de editor no serviço de gerenciamento de catálogos
    • Função do visualizador em todos os grupos de recursos em sua conta
    • SecretsReader no serviço Secrets Manager se você planeja armazenar seus valores seguros em uma instância de Secrets Manager
    • Função de leitor no serviço Security and Compliance Center
    • Outras funções necessárias para recursos específicos em sua arquitetura implementável personalizada.
  • Certifique-se de ter o código-fonte da sua arquitetura implementável armazenado em um GitHub. Para obter ajuda sobre como colocar seu código-fonte em um repositório, consulte Configuração do repositório de código-fonte.
  • Um módulo do Terraform em um repositório público ou privado do GitHub que é clonado em uma pasta local. Para fins de experimentação, você pode criar uma bifurcação desse módulo de amostra do Terraform. Se o seu repositório for privado, você precisará de um token de acesso pessoal com permissões repo e read:user.

Obtendo a extensão do VS Code

Para obter a extensão, abra o VS Code, vá para Extensões, pesquise e selecione IBM Cloud Deployable Architecture Builder para fazer o download. Após o download, você pode seguir o passo a passo para começar ou usar as etapas a seguir. Se o passo a passo não abrir automaticamente, você poderá usar a paleta de comandos. Vá para Exibir > Paleta de comandos. Procure por Walkthrough, clique em Bem-vindo: Open Walkthrough... e, em seguida, selecione Get started with IBM Cloud Deployable Architecture Builder.

Integração de sua arquitetura implementável

Na primeira vez em que você valida sua arquitetura implementável, você segue as etapas para integrá-la ao IBM Cloud. Use as etapas a seguir para integrar sua arquitetura implementável:

  1. Efetue login em sua conta do IBM Cloud.
    1. Para fazer login em sua conta, clique em View (Exibir ) e selecione Command Palette (Paleta de comandos).
    2. No campo de pesquisa, procure por IBM Cloud - Log in.
    3. Selecione IBM Cloud- Log in e faça login com uma chave de API, ID federada ou nome de usuário e senha.
    4. (Opcional) Você pode alterar seu ambiente de login. Clique em Ver, selecione Paleta de comandos, procure por IBM Cloud - Log in e selecione IBM Cloud- Log in > Change login environment. No menu, selecione Production (Produção ) ou Staging (Preparação).
  2. Verifique se você está conectado ao GitHub a partir do VS Code.
    1. Selecione o ícone Avatar > Entrar em Configurações de sincronização.
    2. Selecione sua conta.
    3. Clique em Authorize Visual-Studio-Code.
  3. Clone seu repositório e adicione-o a um espaço de trabalho do VS Code.
    1. Clone seu repositório de arquiteturas implantáveis do GitHub.
    2. Para adicioná-lo ao seu espaço de trabalho no VS Code, clique em Arquivo > Adicionar pasta ao espaço de trabalho... e selecione o repositório em seus arquivos.
  4. Adicione os arquivos de manifesto do catálogo ao módulo Terraform.
    1. Para adicionar o manifesto do catálogo, clique com o botão direito do mouse na pasta do módulo em seu espaço de trabalho.
    2. Selecione IBM Cloud > Adicione arquivos de manifesto de arquitetura implementáveis.
  5. Integre e valide sua arquitetura implementável.
    1. Clique com o botão direito do mouse no arquivo ibm_catalog.json e selecione IBM Cloud > Validar uma arquitetura implementável em IBM Cloud.
    2. Selecione o ramo do repositório. Ou você pode clicar em + e digitar o nome de um novo que será criado.
    3. Selecione um catálogo privado existente. Ou você pode clicar em + e digitar o nome de um novo que será criado.
    4. Digite a versão da oferta.
    5. Selecione um projeto existente. Ou você pode clicar em + e digitar o nome de um novo que será criado para você.
    6. Digite sua IBM Cloud Para a conta em que os recursos serão implementados.
    7. Digite o caminho relativo para o diagrama arquitetônico. Se você não tiver um diagrama, será fornecido um espaço reservado.
    8. (Opcional) Se o repositório GitHub for privado ou estiver no GitHub Enterprise, insira seu token de acesso pessoal.
    9. O arquivo de entradas YAML é aberto. Edite os valores na propriedade inputs e salve o arquivo.
    10. Clique em Continuar

Quando a validação começa, é aberto um canal de saída que mostra os registros de validação. Se isso não acontecer, na exibição de Saída, selecione o canal DA Validation no menu. A validação pode levar vários minutos para ser concluída.