Skip to main content

Como adicionar recursos a um arquivo devcontainer.json

Com os recursos, você pode adicionar rapidamente ferramentas, runtimes ou bibliotecas à configuração do contêiner de desenvolvimento.

Os recursos são unidades autossuficientes de código de instalação e configuração de contêiner de desenvolvimento, projetadas para funcionar em uma ampla gama de imagens de contêiner base. Você pode usar recursos para adicionar rapidamente ferramentas, runtimes ou bibliotecas à imagem do codespace. Para saber mais, confira os recursos disponíveis e a especificação de recursos no site dos Contêineres de Desenvolvimento.

Você pode adicionar recursos a um arquivo devcontainer.json do VS Code ou do repositório no GitHub.com. Use as guias deste artigo para ver instruções de cada uma dessas maneiras de adicionar recursos.

Com adicionar recursos para um arquivo devcontainer.json

  1. Navegue até o repositório em GitHub.com, localize o arquivo devcontainer.json e clique em para editar o arquivo.

    Se você ainda não tiver o arquivo devcontainer.json, crie-o agora. Para obter mais informações, confira "Introdução aos contêineres de desenvolvimento".

  2. À direita do editor de arquivos, na guia Marketplace, procure ou pesquise o recurso que deseja adicionar e clique no nome do recurso.

    Captura de tela da guia "Marketplace" com "Terra" na caixa de pesquisa e o recurso "Terraform" listado nos resultados da pesquisa.

  3. Em "Instalação", clique no snippet de código para copiá-lo na área de transferência e cole o snippet no objeto features no arquivo devcontainer.json.

    Captura de tela da guia "Marketplace" mostrando o trecho de código de instalação do "Terraform".

    "features": {
         // ...
         "ghcr.io/devcontainers/features/terraform:1": {},
         // ...
     }
    
  4. Por padrão, a versão mais recente do recurso será usada. Para escolher uma versão diferente ou configurar outras opções para o recurso, expanda as propriedades listadas em "Opções" para exibir os valores disponíveis e adicione as opções editando manualmente o objeto no arquivo devcontainer.json.

    Captura de tela da seção "Opções" da guia "Marketplace", com as propriedades "version" e "tflint" expandidas.

    "features": {
         // ...
         "ghcr.io/devcontainers/features/terraform:1": {
             "version": "1.1",
             "tflint": "latest"
         },
         // ...
     }
    
  5. Faça commit das alterações no arquivo devcontainer.json.

As alterações de configuração entrarão em vigor nos novos codespaces criados por meio do repositório. Para fazer com que as alterações entrem em vigor nos codespaces existentes, você precisará efetuar pull das atualizações para o arquivo devcontainer.json no codespace e depois recompilar o contêiner para o codespace. Para obter mais informações, confira "Introdução aos contêineres de desenvolvimento".

Para adicionar recursos no VS Code enquanto você está trabalhando localmente e não está conectado a um codespace, a extensão "Contêineres de Desenvolvimento" precisa estar instalada e habilitada. Para obter mais informações sobre essa extensão, confira VS Code Marketplace.

  1. Acesse o VS Code Command Palette com Shift+Comando+P (Mac) ou Ctrl+Shift+P (Windows/Linux).

  2. Comece a digitar "adicionar desenvolvimento" e clique em Codespaces: Adicionar Arquivos de Configuração de Contêiner de Desenvolvimento.

    Captura de tela da Paleta de Comandos, com "adicionar desenvolvimento" inserido e "Codespaces: Adicionar arquivos de configuração do contêiner de desenvolvimento" listados.

  3. Clique em Modificar a configuração ativa.

  4. Atualize suas seleções de recursos e clique em OK.

  5. Se você estiver trabalhando em um codespace, um prompt será exibido no canto inferior direito. Para recompilar o contêiner e aplicar as alterações ao codespace no qual você está trabalhando, clique em Recompilar Agora.

    Captura de tela da mensagem: "Notamos uma alteração na configuração do contêiner de desenvolvimento". Abaixo está o botão "Recompilar agora".