Configurar imagens para personalizações da equipe do Dev Box
Usar um arquivo de personalização simplifica a criação de caixas de desenvolvimento para sua equipe. Com as personalizações da caixa de desenvolvimento, você pode criar uma personalização de equipe compartilhada criando um arquivo chamado definição de imagem. Criar uma imagem reutilizável a partir dessa definição de imagem otimiza as personalizações e economiza tempo durante a criação da caixa de desenvolvimento. Neste artigo, você aprenderá a configurar um pool para usar uma definição de imagem e criar imagens reutilizáveis para suas equipes de desenvolvimento.
Para configurar imagens para personalizações da equipe do Microsoft Dev Box, habilite catálogos no nível do projeto e defina as configurações de sincronização do catálogo para o projeto. Em seguida, anexe um catálogo que contenha um arquivo de definição ao seu projeto, configure um pool de caixas de desenvolvimento para usar uma definição de imagem e verifique se as personalizações se aplicam a uma nova caixa de desenvolvimento. Quando as personalizações se aplicam corretamente, você pode optar por criar uma imagem reutilizável, o que torna a criação de novas caixas de desenvolvimento mais rápida.
Importante
O recurso de personalizações da equipe da Caixa de Desenvolvimento está atualmente em visualização. Para obter mais informações sobre o status da visualização, consulte os Termos de Uso Suplementares para Visualizações do Microsoft Azure. O documento define termos legais que se aplicam a recursos do Azure que estão em versão beta, em visualização ou ainda não lançados em disponibilidade geral.
Pré-requisitos
Para concluir as etapas neste artigo, você precisa:
- Um centro de desenvolvimento com uma definição de caixa de desenvolvimento existente e conexão de rede. Se você não tiver um centro de desenvolvimento, siga as etapas em Guia de início rápido: Configurar o Microsoft Dev Box para criá-lo.
- Um arquivo de personalização de equipe que você deseja usar para criar uma caixa de desenvolvimento. Se você não tiver um arquivo de personalização, consulte Escrever um arquivo de personalização para uma caixa de desenvolvimento.
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 no nível do projeto para um centro de desenvolvimento. | Engenheiro de plataforma com acesso de gravação na assinatura. |
| Habilite as configurações de sincronização de catálogo para um projeto. | Engenheiro de plataforma com acesso de gravação na assinatura. |
| Anexe um catálogo a um projeto. | Permissões de Administrador ou Colaborador do Projeto no projeto. |
| Crie um arquivo de personalização. | Nenhum especificado. Qualquer pessoa pode criar um arquivo de personalização. |
| Use o portal do desenvolvedor para carregar e aplicar um arquivo YAML durante a criação da caixa de desenvolvimento. | Usuário do Dev Box. |
| Adicionar tarefas a um catálogo. | Permissão para adicionar ao repositório que hospeda o catálogo. |
Para gerenciar um pool de caixas de desenvolvimento, você precisa das seguintes permissões:
| Ação | Permissão |
|---|---|
| Crie, exclua ou atualize um pool de caixas 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 administrador do projeto 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 Configurar catálogos no nível do projeto.
Definir configurações de sincronização de catálogo para o projeto
Configure seu projeto para sincronizar definições de imagem do catálogo. Com essa configuração, você pode usar as definições de imagem no catálogo para criar pools de caixas de desenvolvimento.
Inicie sessão no portal do Azure.
Na caixa de pesquisa, insira projetos. Na lista de resultados, selecione Projetos.
Abra o projeto Dev Box para o qual você deseja definir as configurações de sincronização do catálogo.
Selecione Catálogos.
Selecione Configurações de sincronização.
No painel Definições de sincronização, selecione Definições de imagem e, em seguida, selecione Guardar.
Anexar um catálogo que contenha o arquivo de definição
Antes de usar um arquivo de personalização como uma definição de imagem, você deve anexar um catálogo que contenha o arquivo de definição ao seu centro de desenvolvimento ou projeto. O catálogo pode ser do GitHub ou Azure Repos.
O painel Definições de imagem lista as definições de imagem que seu projeto pode acessar.
Para obter mais informações sobre como anexar catálogos, consulte Adicionar e configurar um catálogo do GitHub ou Azure Repos.
Configurar um pool de caixas de desenvolvimento para usar uma definição de imagem
Disponibilize personalizações para suas equipes de desenvolvimento configurando um pool de caixas de desenvolvimento para usar um arquivo de personalização (imagedefinition.yaml). Armazene o arquivo de personalização em um repositório vinculado a um catálogo em seu centro de desenvolvimento ou projeto. Especifique esse arquivo como a definição de imagem para o pool e as personalizações serão aplicadas a novas caixas de desenvolvimento.
As etapas a seguir mostram como criar um pool de caixas de desenvolvimento e especificar uma definição de imagem:
Inicie sessão no portal do Azure.
Na caixa de pesquisa, insira projetos. Na lista de resultados, selecione Projetos.
Abra o projeto Dev Box ao qual você deseja associar o novo pool de caixas de desenvolvimento.
Selecione Pools de caixas de desenvolvimento e, em seguida, selecione Criar.
No painel Criar um pool de caixas de desenvolvimento, insira os seguintes valores:
Definição Valor Nome Insira um nome para o pool. O nome do pool é visível para os desenvolvedores selecionarem quando estiverem criando caixas de desenvolvimento. Deve ser único dentro de um projeto. Definição Esta caixa lista definições de imagem de catálogos acessíveis e definições de caixa de desenvolvimento. Selecione um arquivo de definição de imagem. Ligação de rede Selecione Implantar em uma rede hospedada pela Microsoft ou usar uma conexão de rede existente. Habilitar logon único Selecione Sim para habilitar o logon único para as caixas de desenvolvimento neste pool. O logon único deve ser configurado para a organização. Para obter mais informações, consulte Habilitar logon único para caixas de desenvolvimento. Privilégios de criador da caixa de desenvolvimento Selecione Administrador Local ou Usuário Padrão. Ativar Autosstop Sim é o padrão. Selecione Não para desativar uma agenda de parada automática. Você pode configurar uma agenda de parada automática após a criação do pool. Tempo de paragem Selecione um horário para desligar todas as caixas de desenvolvimento no pool. Time zone (Fuso horário) Selecione o fuso horário em que a hora de parada está. Licenciamento Marque essa caixa de seleção para confirmar se sua organização tem licenças do Benefício Híbrido do Azure que você deseja aplicar às caixas de desenvolvimento neste pool. 
Selecione Criar.
Verifique se o novo pool de caixas de desenvolvimento aparece na lista. Talvez seja necessário atualizar a tela.
Criar uma caixa de desenvolvimento usando o portal do desenvolvedor
Para verificar se as personalizações do arquivo de definição de imagem são aplicadas, crie uma caixa de desenvolvimento no portal do desenvolvedor do Microsoft Dev Box. Siga as etapas em Guia de início rápido: criar e conectar-se a uma caixa de desenvolvimento usando o portal do desenvolvedor do Microsoft Dev Box. Em seguida, conecte-se à caixa de desenvolvimento recém-criada e verifique se as personalizações funcionam como esperado.
Você pode fazer ajustes no arquivo de personalização e criar uma nova caixa de desenvolvimento para testar as alterações. Quando estiver satisfeito com o facto de as personalizações estarem corretas, pode criar uma imagem reutilizável.
Crie uma imagem reutilizável
Para otimizar as personalizações e criar uma imagem reutilizável para sua equipe, você pode usar as etapas a seguir para criar uma imagem a partir do arquivo de personalização. Esta imagem se aplica a todas as caixas de desenvolvimento criadas a partir do pool.
No painel Definições de imagem, selecione a imagem que deseja criar.
Selecione Construir.
Acompanhe o progresso da compilação na coluna Status .
Importante
Quando você está otimizando sua definição de imagem em uma imagem, uma caixa de desenvolvimento é criada para executar seu arquivo de personalização e gerar uma imagem. Durante esse processo, essa caixa de desenvolvimento é conectada a uma rede virtual gerenciada pela Microsoft. As tarefas que exigem acesso a recursos locais podem falhar.
Quando a compilação é concluída com êxito, o pool de caixas de desenvolvimento usa automaticamente a imagem para novas caixas de desenvolvimento. Você não precisa fazer nenhuma configuração extra para atribuir a imagem ao pool. Agora você pode criar caixas de desenvolvimento a partir do pool e as personalizações são aplicadas a cada caixa de desenvolvimento.