Skip to main content

​
O que é o ambiente do Devin?

O ambiente do Devin é o workspace em que o Devin opera: uma máquina virtual baseada em Linux com seus repositórios clonados, ferramentas instaladas, dependências resolvidas, variáveis de ambiente definidas e configurações aplicadas. É o equivalente ao notebook de um desenvolvedor: o sistema operacional, o terminal, a toolchain instalada, os repositórios clonados e as credenciais e configurações de que essas ferramentas precisam. A configuração do seu ambiente é salva como um snapshot: uma imagem congelada e inicializável a partir da qual cada sessão é iniciada. Configure-o uma vez, e toda sessão será iniciada nesse estado conhecido e confiável.

​
Por que a configuração do ambiente é importante

O Devin funciona da mesma forma que qualquer desenvolvedor: clona repositórios, instala dependências, executa lint, compila código e roda testes. Para fazer qualquer uma dessas coisas, ele precisa de um ambiente funcional. Sem isso, o Devin não consegue fazer o build do seu projeto, não consegue rodar seus testes e não consegue verificar o próprio trabalho. Seria como contratar um desenvolvedor e não dar a ele um laptop. A configuração do ambiente dá ao Devin as ferramentas, runtimes, credenciais, variáveis de ambiente e o conhecimento do projeto de que ele precisa para ser produtivo desde a primeira sessão. Ela também torna as sessões mais rápidas: seu snapshot já tem repositórios clonados e dependências instaladas, então o Devin entra direto em trabalho produtivo, em vez de configurar tudo do zero toda vez. Esta é, de longe, a ação de maior impacto que você pode tomar para melhorar a eficácia do Devin na sua base de código. Para um passo a passo em vídeo, veja o tutorial de configuração do repositório.

​
Como as sessões funcionam

Toda sessão é iniciada a partir de um snapshot, uma imagem congelada e inicializável do ambiente.
  1. Snapshot: Uma imagem pré-criada que contém seus repositórios, ferramentas e dependências. É preparada antecipadamente por meio da configuração.
  2. Sessão: O Devin inicia uma nova cópia do snapshot. Toda sessão começa no mesmo estado limpo. As alterações feitas na sessão não são persistidas no snapshot.
Quando sua configuração muda, um novo snapshot é criado automaticamente. Cada organização tem um snapshot ativo por plataforma: Linux por padrão, além de Windows ou macOS, caso você os configure. Toda sessão em uma plataforma é iniciada a partir do snapshot dessa plataforma.

​
Antes de começar

Antes de configurar o ambiente do Devin, verifique se ele pode acessar seus repositórios:
  1. Conecte seu provedor de SCM. Vá para Configurações > Conexões e conecte GitHub, GitLab, Bitbucket ou Azure DevOps. Selecione quais repositórios o Devin poderá acessar durante a configuração. Consulte os guias de integração para instruções detalhadas.
É isso. Depois de conectar, você pode prosseguir para a configuração do ambiente.
  1. Conecte seu provedor de SCM (administrador Enterprise). Vá para Configurações > Conexões e conecte seu provedor de SCM. Consulte Git Integrations para ver as instruções de configuração.
  2. Conceda a cada org acesso aos seus repositórios (administrador Enterprise). Vá para Configurações > Repositórios e atribua repositórios a cada organização. As orgs não podem ver nem usar repositórios até que você conceda esse acesso explicitamente. Consulte Repository Permissions.
  3. Configure o ambiente (administrador da org). Quando uma org tiver acesso aos repositórios, prossiga para a configuração do ambiente abaixo.
Se você pular essas etapas, os repositórios não aparecerão quando você tentar adicioná-los ao seu ambiente. O Devin precisa de acesso aos repositórios por meio da sua integração com Git antes de poder clonar e fazer o build.

​
Configure pedindo ao Devin

Esta é a maneira mais simples de configurar o ambiente do Devin e funciona para a maioria dos repositórios.
Inicie uma sessão do Devin e peça: “Configure seu ambiente para este repo.”
1

Devin explora seu repositório

Devin inspeciona sua base de código e identifica as ferramentas, os runtimes e as dependências necessários.
2

Revise as sugestões

Devin propõe um blueprint em cartões de sugestão na linha do tempo. Revise a configuração proposta e aprove os cartões que quiser usar.
3

Um build cria o snapshot

Devin executa um build com base no blueprint aprovado e gera o snapshot do qual todas as sessões são inicializadas.
Para ver o passo a passo completo, consulte Deixe o Devin fazer isso.

​
Variáveis de ambiente e segredos

As variáveis de ambiente fazem parte do seu blueprint. Defina valores não sensíveis no campo env de uma etapa ou grave valores compartilhados em $ENVRC; consulte os templates de ambiente para ver os padrões de $ENVRC e direnv. O Devin pode inferir ferramentas e dependências do seu repositório, mas não consegue descobrir suas credenciais. Armazene valores sensíveis como Segredos criptografados na aba Segredos do editor de blueprint e faça referência a eles como $VARIABLE_NAME. Os segredos são injetados como variáveis de ambiente durante builds e sessões; consulte o guia de segredos de blueprint e a referência de variáveis de ambiente e segredos.

​
Escolha sua abordagem

Pedir ao Devin é o padrão. Se quiser criar a configuração por conta própria, use a configuração declarativa, o caminho manual recomendado. Blueprints descrevem seu ambiente, e as builds geram snapshots automaticamente.

Configuração declarativa

Caminho manual recomendado. Revise ou edite o YAML que o Devin gera para controlar o que é instalado, como as dependências são configuradas e o que o Devin deve saber.
  • Com controle de versão
  • Atualização automática
  • Componível entre camadas
  • Reproduzível

Referência de blueprints

Especificação completa dos campos de blueprints: seções, suporte a GitHub Actions, variáveis de ambiente e anexos de arquivos.

Biblioteca de templates

Blueprints prontos para copiar e colar para Python, Node.js, Go, Java, Ruby, Rust e padrões avançados.

Gerenciamento de ambientes Enterprise

Gerenciamento de ambientes em toda a Enterprise: hierarquia de 3 níveis, segredos e configuração entre orgs.