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.

Pré-requisitos

Criar uma definição de imagem

Para criar uma caixa de desenvolvimento com personalizações, você deve criar um arquivo de definição de imagem. O arquivo de definição de imagem é um arquivo YAML que contém as personalizações que você deseja aplicar à caixa de desenvolvimento. Você pode usar o arquivo de definição de imagem de exemplo neste início rápido como ponto de partida.

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ções do Centro de desenvolvimento.

3. Em 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. Faça um fork do repositório de catálogo de exemplo para a sua organização GitHub.
2. Configure as configurações de sincronização para sincronizar o catálogo com seu projeto.
3. Adicione seu repositório como um catálogo.

Fork o repositório de exemplo de catálogo

1. Abra o repositório do catálogo de exemplo.

2. Selecione Fork>Criar uma nova bifurcação para bifurcar o repositório para sua organização do GitHub.

   

Definir configurações de sincronização de catálogo

1. Volte para o portal do Azure.

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

3. Selecione o projeto ao qual deseja adicionar o catálogo.

4. No menu à esquerda, selecione Catálogos de configurações>.

5. Selecione Configurações de sincronização.

   

6. No painel Configurações de sincronização :

   • Se as definições de imagem estiverem desmarcadas, selecione-a e selecione Salvar.
   • Se as definições de imagem já estiverem selecionadas, selecione Cancelar.

   

Adicione seu repositório como um catálogo

1. Na página Catálogos, selecione Adicionar.

2. 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.

3. Selecione o link Configurar seus repositórios .

   

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

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

   

6. 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.

   

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

   

   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.

8. Volte para o portal do Azure.

9. No painel Adicionar catálogo , selecione Entrar com o GitHub.

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

    Campo	Valor
    Repositório	Selecione o repositório que contém a definição da imagem. Exemplo: eShop
    Ramo	Selecione a ramificação. Exemplo: main
    Caminho da pasta	Selecione a pasta que contém subpastas que contêm suas definições de imagem. Exemplo: .devcenter/catalog/image-definitions

11. 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.

    

12. Verifique se as definições de imagem estão sincronizadas corretamente. No menu à esquerda, selecione Gerenciar>definições de imagem. Neste exemplo, você verá duas definições de imagem:

    • backend-dev - Esta imagem é uma imagem do Microsoft Visual Studio + Tools no Windows 11, adequada para o ambiente de engenharia de back-end da eShop.
    • frontend-dev - Esta imagem é uma imagem do Microsoft Visual Studio + Tools no Windows 11, adequada para o ambiente de engenharia de frontend da eShop.

    

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 caixas de desenvolvimento associado a um projeto:

1. 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. No menu à esquerda, selecione Gerenciar>pools de caixas de desenvolvimento

5. Na página Pools de caixas de desenvolvimento , selecione Criar.

6. No painel Criar um pool de caixas de desenvolvimento, insira os seguintes valores:

   Configuração	Valor
   Nome	Insira um nome descritivo para o pool. O nome do pool é visível para os desenvolvedores selecionarem quando estiverem criando caixas de desenvolvimento, portanto, inclua a finalidade e a região do pool. O nome deve ser exclusivo dentro de um projeto. Exemplo: contoso-frontend-westUS
   Definição	Na seção de definição de imagem da lista, selecione uma definição de imagem. Exemplo: contoso-catalog/frontend-dev
   Computar	Selecione os recursos de computação para as caixas de desenvolvimento no pool. Exemplo: 8 vCPU, 32 GB de RAM
   Armazenamento	Selecione as opções de armazenamento para as caixas de desenvolvimento no pool. Exemplo: SSD de 256 GB
   Hibernação	A hibernação é suportada quando a imagem de origem e o tamanho da computação são compatíveis com a hibernação.
   Ligação de rede	1. Selecione Implantar em uma rede hospedada pela Microsoft. 2. Selecione uma região de implantação 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. Exemplo: Oeste dos EUA
   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.

   

7. Selecione Criar.

8. Verifique se o novo 'dev box pool' 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 de desenvolvedores Microsoft Dev Box.

2. Selecione Nova>caixa de desenvolvimento.

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

   Configuração	Valor
   Nome	Insira um nome para sua caixa de desenvolvimento. Os nomes das caixas de desenvolvimento devem ser exclusivos dentro de um projeto. Exemplo: contoso-frontend-dev-box
   Projeto	O portal do desenvolvedor lista os projetos aos quais você tem acesso. Selecione o projeto que você precisa na lista.
   Pool de caixas de desenvolvimento	O portal do desenvolvedor lista todos os pools de caixas de desenvolvimento para o projeto selecionado. Selecione a piscina apropriada para o seu trabalho. Escolha um pool de caixas de desenvolvimento perto de você para obter a menor latência.
   Aplicar personalizações	Deixe esta caixa de seleção desmarcada. Ele é usado para aplicar personalizações do usuário. Neste artigo, você configurou personalizações de equipe.

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

   • Se a hibernação é suportada ou não.
   • 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 as personalizações são aplicadas

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 até que a caixa de desenvolvimento seja criada.

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

   

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

   

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 do Microsoft Dev Box
• Escrever um arquivo de personalização para uma caixa de desenvolvimento