Guia de início rápido: criar uma caixa de desenvolvimento usando personalizações de equipe

Neste início rápido, você cria uma caixa de desenvolvimento usando personalizações da equipe do Microsoft Dev Box. O recurso usa um arquivo de definição de imagem para que você possa criar caixas de desenvolvimento consistentemente personalizadas para sua equipe de desenvolvimento e fornecer um ambiente personalizado para seus projetos.

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 início rápido, você deve ter um centro de desenvolvimento configurado com um projeto de 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.

Criar uma definição de imagem

1. Baixe o arquivo de personalização YAML de exemplo.
2. Abra o arquivo e examine as tarefas.

O arquivo de definição de imagem especifica um nome para a definição de imagem usando um name campo. Use esse nome para identificar a definição de imagem no pool de caixas de desenvolvimento.

Habilitar catálogos no nível do projeto

Você deve habilitar catálogos no nível do projeto no nível do centro de desenvolvimento antes de poder adicionar um catálogo a um projeto.

1. No portal do Azure, vá para o seu centro de desenvolvimento.

2. No menu de serviço, em Configurações, selecione Configuração.

   

3. No painel Catálogos de nível de projeto, selecione Habilitar catálogos por projeto e, em seguida, selecione Aplicar.

   

Adicionar um catálogo ao seu projeto

As secções que se seguem orientam-no através destas tarefas:

1. Fork o repositório de catálogo de exemplo para sua organização GitHub.
2. Instale e configure o aplicativo Microsoft Dev Center.
3. Atribua permissões no GitHub para os repositórios.
4. Adicione seu repositório como um catálogo.

Fork o repositório de catálogo de exemplo

1. Abra o repositório de catálogo de exemplo.
2. Selecione Fork para bifurcar o repositório para sua organização do GitHub.

Instalar o aplicativo Centro de Desenvolvimento da Microsoft

1. Inicie sessão no portal do Azure.

2. Vá para o seu centro de desenvolvimento ou projeto.

3. No menu de serviço, em Configuração do ambiente, selecione Catálogos e, em seguida, selecione Adicionar.

4. No painel Adicionar catálogo, insira ou selecione os seguintes valores:

   Campo	Valor
   Nome	Introduza um nome para o catálogo.
   Fonte do catálogo	Selecione GitHub.
   Tipo de autenticação	Selecione o aplicativo GitHub.

5. Selecione o link Configurar seus repositórios .

   

6. Se você for solicitado a se autenticar no GitHub, autentique-se.

7. Na página Microsoft DevCenter, selecione Configurar.

   

8. Selecione a organização do GitHub que contém o repositório que você deseja adicionar como catálogo. Você deve ser um proprietário da organização para instalar este aplicativo.

   

9. Na página Instalar o Microsoft DevCenter , selecione Selecionar apenas repositórios, selecione o repositório que deseja adicionar como catálogo e selecione Instalar.

   

   Você pode selecionar vários repositórios para adicionar como catálogos. Você deve adicionar cada repositório como um catálogo separado, conforme descrito na próxima seção deste início rápido.

10. Na página Microsoft DevCenter by Microsoft would want permission to, revise as permissões necessárias e selecione Autorizar Microsoft DevCenter.

    

Adicione seu repositório como um catálogo

1. Regresse ao portal do Azure.

2. No painel Adicionar catálogo, insira as seguintes informações e selecione Adicionar:

   Campo	Value
   Repositório	Selecione o repositório que você deseja adicionar como um catálogo.
   Ramo	Selecione a ramificação.
   Folder path	Selecione a pasta que contém subpastas que contêm suas definições de ambiente.

   

3. No painel Catálogos, verifique se o catálogo é exibido. Quando a conexão for bem-sucedida, a coluna Status mostrará Sincronização bem-sucedida.

   

Criar um pool de caixas de desenvolvimento para a definição da imagem

Para tornar o arquivo de personalização, imagedefintion.yaml, acessível para a criação de caixas de desenvolvimento, especifique-o como a definição de imagem para um pool.

Para criar um pool de caixa de desenvolvimento associado a um projeto:

1. Inicie sessão no portal do Azure.

2. Na caixa de pesquisa, insira projetos. Na lista de resultados, selecione Projetos.

3. Abra o projeto no qual você deseja criar o pool de caixas de desenvolvimento.

4. Selecione Pools de caixas de desenvolvimento e, em seguida, selecione Criar.

5. 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. O nome deve ser exclusivo dentro de um projeto.
   Definição	Selecione a definição, conforme nomeado no arquivo de definição de imagem.
   Ligação de rede	1. Selecione Implantar em uma rede hospedada pela Microsoft. 2. Selecione a região de implantação desejada para as caixas de desenvolvimento. Escolha uma região próxima aos usuários da sua caixa de desenvolvimento para obter a melhor experiência do usuário.
   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. Todas as caixas de desenvolvimento nesta piscina fecham a esta hora todos os dias.
   Time zone (Fuso horário)	Selecione o fuso horário para a hora de parada.
   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.

   

6. Selecione Criar.

7. Verifique se o novo pool de caixas de desenvolvimento aparece na lista. Talvez seja necessário atualizar a tela.

O portal do Azure implanta o pool de caixas de desenvolvimento e executa verificações de integridade para garantir que a imagem e a rede passem pelos critérios de validação para caixas de desenvolvimento.

Criar uma caixa de desenvolvimento a partir do pool de caixas de desenvolvimento

Quando você cria uma caixa de desenvolvimento a partir de um pool de caixas de desenvolvimento, a definição de imagem é aplicada à caixa de desenvolvimento. A caixa de desenvolvimento é criada com as personalizações especificadas pelo arquivo de definição de imagem.

Para criar uma caixa de desenvolvimento no portal do desenvolvedor do Microsoft Dev Box:

1. Entre no portal do desenvolvedor do Microsoft Dev Box.

2. Selecione Nova>caixa de desenvolvimento.

3. Em Adicionar uma caixa de desenvolvimento, insira os seguintes valores:

   Definição	Valor
   Nome	Insira um nome para sua caixa de desenvolvimento. Os nomes das caixas de desenvolvimento devem ser exclusivos dentro de um projeto.
   Projeto	Selecione um projeto na lista suspensa.
   Pool de caixas de desenvolvimento	Selecione um pool na lista suspensa, que inclui todos os pools de caixas de desenvolvimento para esse projeto. Escolha um pool de caixas de desenvolvimento perto de você para obter a menor latência.

   Depois de fazer suas seleções, a página mostra as seguintes informações:

   • Quantas caixas de desenvolvimento você pode criar no projeto selecionado, se o projeto tiver limites configurados.
   • Se a hibernação é suportada ou não.
   • Se as personalizações estão habilitadas ou não.
   • Um tempo de desligamento se o pool onde você está criando a caixa de desenvolvimento tiver uma agenda de desligamento.
   • Uma notificação de que o processo de criação da caixa de desenvolvimento pode levar 25 minutos ou mais.

4. Selecione Criar para começar a criar sua caixa de desenvolvimento.

5. Para acompanhar o progresso da criação, use o bloco da caixa de desenvolvimento no portal do desenvolvedor.

Verifique se a personalização é aplicada

O Dev Box aplica personalizações como o estágio final do processo de criação. A Dev Box envia e-mails para você quando a caixa de desenvolvimento estiver pronta. Em seguida, você pode verificar se suas personalizações são aplicadas.

1. Aguarde a confirmação por e-mail de que a caixa de desenvolvimento foi criada.

2. No portal do desenvolvedor, no bloco da caixa de desenvolvimento, selecione Personalizações>de ações.

   

3. No painel Detalhes da personalização, confirme as personalizações que foram aplicadas à caixa de desenvolvimento.

   

Clean up resources (Limpar recursos)

1. Faça login no portal do desenvolvedor.

2. Para a caixa de desenvolvimento que você deseja excluir, no menu Ações , selecione Excluir.

   

3. Para confirmar a exclusão, selecione Excluir.

   

Conteúdos relacionados

• Personalizações da equipe do Microsoft Dev Box
• Escrever um arquivo de personalização para uma caixa de desenvolvimento