Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

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 do recurso Terraform na guia Marketplace, com "Terra" na barra de 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 de um bloco de código na seção Instalação da guia Marketplace

    "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 "version" e "tflint" expandidos

    "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 "configurar" e clique em Codespaces: configurar contêiner de desenvolvimento.

    Captura de tela da opção 'Configurar contêiner de desenvolvimento' na paleta de comandos

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

    Captura de tela da opção 'Modificar a configuração ativa' na paleta de comandos

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

    Captura de tela do menu de recursos adicionais durante a configuração do contêiner

  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 opção 'Codespaces: recompilar contêiner' na paleta de comandos