Crie tarefas para personalizações da equipe do Computador de Desenvolvimento da Microsoft
Ao criar tarefas para personalizações de equipe do Computador de Desenvolvimento da Microsoft, você pode definir ações específicas para suas dev boxes para ajudar a garantir um ambiente de desenvolvimento consistente e eficiente. Criar novas tarefas em um catálogo permite que você defina componentes reutilizáveis adaptados às suas equipes de desenvolvimento e adicione proteções em torno das configurações possíveis. Este artigo orienta você a criar um catálogo para tarefas de personalização, adicionar tarefas e anexar o catálogo a um centro de desenvolvimento ou projeto.
Importante
O recurso de personalização da equipe do Computador de Desenvolvimento da Microsoft está atualmente em versão prévia. Para obter mais informações sobre o status de visualização, consulte os Termos de Uso Complementares para Visualizações do Microsoft Azure. O documento define os termos legais que se aplicam aos recursos do Azure que estão em beta, em versão prévia ou ainda não lançados para disponibilidade geral.
Pré-requisitos
Para concluir as etapas deste artigo, você precisa ter:
- Um centro de desenvolvimento configurado com um projeto de computador de desenvolvimento.
- Um catálogo existente no GitHub ou no Azure Repos.
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 de gravação na assinatura. |
| Habilitar configurações de sincronização de catálogo para um projeto. | Engenheiro de plataforma com acesso de gravação na assinatura. |
| Anexar um catálogo a um projeto. | Permissões de Administrador do Projeto ou Colaborador no projeto. |
| Criar 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 Computador de Desenvolvimento. |
| Adicionar tarefas a um catálogo. | Permissão para adicionar ao repositório que hospeda o catálogo. |
O que são tarefas?
Uma tarefa executa uma ação específica, como instalar software. Cada tarefa consiste em um ou mais scripts do PowerShell, juntamente com um arquivo task.yaml que fornece parâmetros e define como os scripts são executados. Você também pode incluir um comando do PowerShell no arquivo task.yaml.
Você pode armazenar uma coleção de tarefas selecionadas em um catálogo anexado ao seu centro de desenvolvimento, com cada tarefa em uma pasta separada. O Computador de Desenvolvimento da Microsoft oferece suporte ao uso de um repositório GitHub ou um repositório Azure Repos como catálogo. O Computador de Desenvolvimento da Microsoft verifica uma pasta especificada do catálogo recursivamente para encontrar definições de tarefas.
O WinGet e o PowerShell estão disponíveis em qualquer centro de desenvolvimento sem a necessidade de um catálogo. Se suas personalizações usarem apenas WinGet ou PowerShell, você poderá criar tarefas que os utilizem em um arquivo de personalização. Caso precise usar outras ferramentas ou scripts, poderá criar tarefas em um catálogo.
A Microsoft fornece um catálogo de início rápido para ajudar você a começar a usar as personalizações. Inclui um conjunto padrão de tarefas que definem ações comuns:
- Instale o software usando o gerenciador de pacotes WinGet.
- Implante a Desired State Configuration (DSC) usando a Configuração do WinGet.
- Clonar um repositório usando
git-clone. - Configure aplicativos como instalar extensões do Visual Studio.
- Execute scripts do PowerShell.
Criar tarefas em um catálogo
Tarefas, como instalar software ou executar scripts, são organizadas em um catálogo. Você cria e gerencia tarefas em um catálogo, define novas tarefas e anexa seu catálogo a um centro de desenvolvimento. Com o catálogo de início rápido da Microsoft, você pode começar a realizar tarefas comuns, como instalar software, implantar DSC, clonar repositórios e configurar aplicativos.
Definir novas tarefas
Para criar e gerenciar tarefas para personalizações da equipe do Computador de Desenvolvimento da Microsoft, siga essas etapas:
Crie um repositório para armazenar suas tarefas. Opcionalmente, você pode fazer uma cópia do catálogo de início rápido em seu próprio repositório para usar como ponto de partida.
Crie tarefas no seu repositório modificando scripts do PowerShell existentes ou criando novos scripts. Para começar a criar tarefas, você pode usar os exemplos no repositório do GitHub para exemplos do centro de desenvolvimento e na documentação do PowerShell.
Anexe seu repositório ao centro de desenvolvimento como um catálogo.
Crie um arquivo de configuração para essas tarefas seguindo as etapas em Grave um arquivo de personalização.
Use segredos de um cofre de chaves do Azure
Você pode usar segredos do seu cofre de chaves do Azure em suas configurações YAML para clonar repositórios privados ou com qualquer tarefa personalizada que você criar e que exija um token de acesso.
Seu centro de desenvolvimento precisa de acesso ao cofre de chaves. O DevCenter não oferece suporte a marcas de serviço, portanto, se seu cofre de chaves for mantido privado, você deverá permitir que serviços confiáveis da Microsoft ignorem o firewall.
Para configurar os segredos do seu cofre de chaves para uso em suas configurações YAML:
Verifique se a identidade gerenciada do projeto do centro de desenvolvimento tem as funções Leitor do Key Vault e Usuário de Segredos do Key Vault no cofre de chaves.
Conceda a função de usuário dos segredos do Key Vault para o segredo do Key Vault a cada usuário ou grupo de usuários que deve ser capaz de consumir o segredo durante a personalização de uma caixa de desenvolvimento. O usuário ou grupo que recebe a função deve incluir a identidade gerenciada do centro de desenvolvimento, sua própria conta de usuário e qualquer usuário ou grupo que precise do segredo durante a personalização de uma caixa de desenvolvimento.
Para obter mais informações sobre como usar segredos do cofre de chaves em um arquivo de personalização, veja Clonar um repositório privado usando um arquivo de personalização.
Anexar um catálogo
Anexe um catálogo a um projeto para tornar as tarefas acessíveis à equipe de desenvolvedores. Para anexar um catálogo a um projeto, siga as etapas em Adicionar e configurar um catálogo do GitHub ou Azure Repos.