Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O uso de um arquivo de personalização simplifica a criação de computadores de desenvolvimento para sua equipe. Com personalizações de computador de desenvolvimento, você pode criar uma personalização de equipe compartilhada criando um arquivo chamado definição de imagem. Em seguida, você pode criar uma imagem reutilizável a partir dessa definição de imagem para otimizar personalizações e economizar tempo durante a criação da caixa de desenvolvimento.
As imagens são criadas automaticamente por padrão para catálogos que contêm definições de imagem sempre que uma nova definição de imagem é detectada ou uma existente é atualizada. Embora os builds automáticos ajudem a impedir configurações obsoletas e melhorar a confiabilidade do computador de desenvolvimento, eles incorrem em custos por meio de medidores do computador de desenvolvimento durante o runtime. Durante o processo de build de imagem, uma caixa de desenvolvimento é criada para executar seu arquivo de personalização e gerar uma imagem, que incorre em custos com base nos recursos de computação e no tempo necessários para compilar a imagem. É possível desativar builds automáticos de imagem durante a criação do catálogo ou posteriormente nas configurações do catálogo.
Neste artigo, você aprenderá a configurar a imagem do centro de desenvolvimento para suas equipes de desenvolvimento.
Pré-requisitos
Para completar as etapas neste artigo, você precisa:
- Um arquivo de personalização de equipe que você quer usar para criar um computador de desenvolvimento. Se você não tiver um arquivo de personalização, consulte Configurar personalizações de equipe.
Permissões necessárias para configurar personalizações
Para executar as ações necessárias para criar e aplicar personalizações a uma caixa de desenvolvimento, você precisa das seguintes permissões:
| Ação | Permissão/Função |
|---|---|
| Habilite catálogos em nível de projeto para um centro de desenvolvimento. | Engenheiro de plataforma com acesso para gravação na assinatura. |
| Habilitar configurações de sincronização de catálogo para um projeto. | Engenheiro de plataforma com acesso para gravação na assinatura. |
| Anexar um catálogo a um projeto. | Permissões de Administrador do Projeto ou Colaborador no projeto. |
| Adicionar tarefas a um catálogo. | Permissão para adicionar ao repositório que hospeda o catálogo. |
Para gerenciar um pool de computadores de desenvolvimento, você precisa ter as seguintes permissões:
| Ação | Permissão |
|---|---|
| Criar, excluir ou atualizar um pool de computadores de desenvolvimento. | – Permissões de proprietário ou colaborador em uma assinatura do Azure ou em um grupo de recursos específico.
- Permissões de Proprietário do DevCenter no centro de desenvolvimento. – Permissões de Administrador do Projeto do DevCenter para o projeto. |
Habilitar catálogos no nível do projeto
Para anexar um catálogo a um projeto, você deve habilitar catálogos no nível do projeto. Para obter mais informações, consulte Adicionar e gerenciar catálogos no Microsoft Dev Box.
Definir configurações de sincronização de catálogo para o projeto
Entre no portal do Azure.
Na caixa de pesquisa, insira projetos. Na lista de resultados, selecione Projetos.
Abra o projeto do Computador de Desenvolvimento para o qual você deseja definir as configurações de sincronização de catálogo.
Selecione Catálogos.
Selecione Configurações de sincronização.
No painel Configurações de sincronização, selecione Definições de imagem e selecione Salvar.
Anexar catálogo que contém o arquivo de definição
Antes de usar um arquivo de personalização como uma definição de imagem, anexe um catálogo que contenha o arquivo de definição ao seu projeto. O catálogo pode ser do GitHub ou do Azure Repos. Para obter mais informações, consulte Adicionar e configurar um catálogo do GitHub ou do Azure Repos.
Observação
As definições de imagem só têm suporte no nível do projeto. Você deve anexar catálogos que contêm definições de imagem a um projeto, não a um centro de desenvolvimento.
O painel Definições de imagem lista as definições de imagem que seu projeto pode acessar.
Criar uma imagem reutilizável
Você pode criar uma imagem reutilizável a partir de uma definição de imagem para otimizar o desempenho e aprimorar a confiabilidade. A imagem criada se aplica a todos os computadores de desenvolvimento criados a partir do pool. O serviço DevCenter cria uma caixa de desenvolvimento nos bastidores, aplica suas personalizações da definição de imagem e exporta a imagem resultante para uma Galeria de Computação do Azure em um grupo de recursos gerenciado.
Há duas maneiras de criar imagens: automáticas ou manuais. Por padrão, as imagens são criadas automaticamente sempre que uma nova definição de imagem é detectada ou uma definição de imagem existente é atualizada. Esse recurso ajuda a evitar configurações obsoletas e melhora a confiabilidade da caixa de desenvolvimento. Para controlar a criação das imagens, desabilite os builds automáticos de imagens e inicie builds manualmente.
Observação
As builds de imagem incorrem em custos por meio de medidores de computador de desenvolvimento durante o runtime quando as personalizações são aplicadas.
Selecione as abas abaixo para aprender como configurar builds de imagem automáticos e manuais.
- Compilações automáticas de imagem para catálogos existentes
- Compilações automáticas de imagem para novos catálogos
- Compilações manuais de imagem
Configurar compilações automáticas de imagem para catálogos existentes
Entre no portal do Azure.
Na caixa de pesquisa, insira projetos. Na lista de resultados, selecione Projetos.
Abra o projeto que contém o catálogo que você deseja configurar.
No menu à esquerda, selecione Catálogos.
Na lista de catálogos, selecione o catálogo que contém definições de imagem.
Na página de detalhes do catálogo, ative ou desative a construção automática de imagem usando a caixa de seleção Criar imagem automaticamente.
Recomendamos habilitar builds automáticos para aproveitar as melhorias de confiabilidade e desempenho fornecidas pela imagem do Centro de Desenvolvimento.Selecione Salvar para aplicar suas alterações. A funcionalidade de build automático mescla personalizações em uma imagem reutilizável que melhora significativamente o desempenho e a confiabilidade na criação do computador de desenvolvimento.
Quando as compilações automáticas de imagem estão desabilitadas, você deve acionar manualmente compilações de imagem quando quiser criar ou atualizar imagens reutilizáveis a partir de suas definições de imagem.
Durante o processo de construção de imagem, o Dev Box cria uma conta de armazenamento temporária em sua assinatura para armazenar um snapshot. Essa conta de armazenamento não permite acesso anônimo a blobs e só pode ser acessada por identidades com acesso ao Leitor de Blobs de Armazenamento. A conta de armazenamento deve estar acessível de redes públicas para que o serviço Dev Box possa exportar seu instantâneo. Se você tiver políticas do Azure que bloqueiam a criação de contas de armazenamento com acesso à rede pública, crie uma exceção para a assinatura em que o projeto do DevCenter está.
Importante
Quando uma imagem é criada a partir de uma definição de imagem, uma caixa de desenvolvimento é criada para aplicar todas as personalizações e gerar uma imagem. Por padrão, se nenhuma rede personalizada estiver configurada no nível de definição de imagem, a caixa de desenvolvimento será conectada a uma rede virtual gerenciada pela Microsoft. Use a propriedade de configuração de rede em definições de imagem para tarefas que precisam de acesso a recursos locais ou privados para garantir que a geração de imagem seja bem-sucedida.
Configurar um pool dos computadores de desenvolvimento para usar uma definição de imagem
Para disponibilizar personalizações para suas equipes de desenvolvimento, configure um pool de caixas de desenvolvimento para usar uma definição de imagem. Armazene o arquivo de personalização (imagedefinition.yaml) em um repositório vinculado a um catálogo em seu projeto. Quando você especifica a definição de imagem para o pool, as personalizações são aplicadas a novas caixas de desenvolvimento.
Criar um pool de computadores de desenvolvimento
No Computador de Desenvolvimento da Microsoft, um pool de computador de desenvolvimento é uma coleção de computadores de desenvolvimento que você gerencia juntos. Você deve ter pelo menos um pool de computadores de desenvolvimento antes que os usuários possam criar um computador de desenvolvimento.
As etapas a seguir mostram como criar um pool de caixas de desenvolvimento em um projeto.
Se você não tiver um centro de desenvolvimento e um projeto disponíveis, siga as etapas no Início Rápido: Configurar o Microsoft Dev Box para criá-los.
Entre no portal do Azure.
Na caixa de pesquisa, insira projetos. Na lista de resultados, selecione Projetos.
Abra o projeto no qual você deseja criar o pool de computador de desenvolvimento.
Selecione Pools de computador de desenvolvimento e, em seguida, selecione Criar.
No painel Criar um pool de caixas de desenvolvimento, na guia Noções básicas, insira os seguintes valores:
Configurações Value Nome Insira um nome para o pool. O nome do pool é visível a desenvolvedores para selecionar quando estão criando computadores de desenvolvimento. O nome deve ser exclusivo em um projeto. Definição Selecione uma definição de imagem. Calcule Selecione o tamanho da máquina virtual para os ambientes de desenvolvimento neste pool. Armazenamento Selecione o tamanho do armazenamento para as caixas de desenvolvimento neste pool. Hibernação Mostra se a hibernação tem suporte ou não. Região Conexão de rede 1. Selecione Implantar em uma rede hospedada da Microsoft.
2. Selecione a região de implantação desejada para as caixas de desenvolvimento. Escolha uma região próxima aos usuários esperados do ambiente de desenvolvimento para uma experiência ideal.Licenciamento Marque esta caixa de seleção para confirmar que a organização tem licenças do Benefício Híbrido do Azure que você deseja aplicar aos computadores de desenvolvimento neste pool. 
Selecione Criar.
Suporte à hibernação para ambientes de desenvolvimento
O Dev Box dá suporte à hibernação quando ambas as condições são atendidas:
- A imagem de origem definida na definição de imagem dá suporte à hibernação.
- Os recursos de computação do pool de máquinas de desenvolvimento dão suporte à hibernação.
Se a imagem ou o pool não der suporte à hibernação, o recurso não estará disponível para caixas de desenvolvimento nesse pool. Se não houver suporte para hibernação, verifique se a imagem base especificada em sua definição de imagem é criada com suporte à hibernação e se o pool usa essa definição de imagem.
Para obter mais informações sobre o suporte do Dev Box para hibernação, consulte Configurar hibernação no Microsoft Dev Box.
Criar um computador de desenvolvimento usando o portal do desenvolvedor
Para verificar se as personalizações são aplicadas corretamente, crie uma caixa de desenvolvimento no portal do desenvolvedor do Microsoft Dev Box. Siga as etapas no Início Rápido: Crie e conecte-se a uma caixa de desenvolvimento usando o portal do desenvolvedor do Microsoft Dev Box, conecte-se à caixa de desenvolvimento recém-criada e verifique se as personalizações funcionam conforme o esperado.
Você pode fazer ajustes na definição de imagem e criar uma nova caixa de desenvolvimento para testar as alterações. Quando as personalizações estiverem corretas, você poderá criar uma imagem reutilizável a partir da definição de imagem.