Adicionar e configurar um catálogo do GitHub ou Azure Repos

Este artigo explica como adicionar e configurar um catálogo para o seu centro de desenvolvimento ou projeto dos Ambientes de Implantação do Azure.

Os catálogos ajudam a fornecer um conjunto de modelos de infraestrutura como código (IaC) com curadoria, conhecidos como definições de ambiente para que suas equipes de desenvolvimento criem ambientes. Você pode anexar seu próprio repositório de controle de origem do GitHub ou do Azure DevOps como um catálogo e especificar a pasta com suas definições de ambiente. Os Ambientes de Implantação verificam a pasta em busca de definições de ambiente e as disponibilizam para as equipes de desenvolvimento criarem ambientes.

Para proteger ainda mais seus modelos, o catálogo é criptografado; Os Ambientes de Implantação do Azure dão suporte à criptografia em repouso com chaves de criptografia gerenciadas pela plataforma, gerenciadas pela Microsoft para Serviços do Azure.

• Para saber como hospedar um repositório no GitHub, consulte Introdução ao GitHub.
• Para saber como hospedar um repositório Git em um projeto Azure Repos, consulte Azure Repos.

A Microsoft oferece um catálogo de início rápido que você pode adicionar ao centro de desenvolvimento ou projeto e um catálogo de exemplo que você pode usar como repositório. Você também pode usar seu próprio repositório privado ou pode bifurcar e personalizar as definições de ambiente no catálogo de exemplo.

Neste artigo, vai aprender a:

1. Configurar catálogos no nível do projeto
2. Configurar uma identidade gerenciada
3. Adicionar um catálogo do Azure Repos ou GitHub
4. Atualizar um catálogo
5. Excluir um catálogo
6. Solucionar erros de sincronização de catálogo

Configurar catálogos no nível do projeto

A anexação de catálogos no nível do projeto permite que os engenheiros de plataforma forneçam definições de ambiente selecionadas que são específicas para as equipes de desenvolvimento. Além disso, ele capacita os líderes da equipe de desenvolvimento designados como administradores de projeto para gerenciar as definições de ambiente disponibilizadas para suas equipes.

Os engenheiros de plataforma têm controle total sobre o uso de catálogos no nível do projeto. O uso de catálogos de nível de projeto deve ser habilitado no nível do centro de desenvolvimento antes que um catálogo possa ser adicionado a um projeto. Os engenheiros de plataforma também podem configurar quais tipos de itens de catálogo, como definições de ambiente, podem ser consumidos no nível do projeto.

Por padrão, o uso de catálogos no nível do projeto é desabilitado e nenhum dos tipos de item de catálogo está habilitado. As definições de ambiente de um catálogo no nível do projeto são sincronizadas e utilizáveis sob duas condições. Primeiro, você deve habilitar catálogos baseados em projeto no nível correspondente do centro de desenvolvimento. Em segundo lugar, você deve habilitar o uso de definições de ambiente para o projeto.

Adicionar um catálogo a um 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. Você também deve habilitar o uso de definições de ambiente no nível do projeto.

Para habilitar o uso de catálogos no nível do projeto no nível do centro de desenvolvimento:

1. No portal do Azure, navegue até o centro de desenvolvimento.

2. No menu à esquerda, 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.

   

Para permitir o uso de definições de ambiente no projeto:

1. No portal do Azure, navegue até seu projeto.

2. No menu à esquerda, em Configurações, selecione Catálogos.

   

3. Na página Catálogos, selecione Permissões de item de catálogo.

   

4. No painel Configurações de item de catálogo, selecione Definições de ambiente de implantação do Azure para habilitar o uso de definições de ambiente no nível do projeto.

   

Agora, você pode adicionar um catálogo ao projeto.

Para catálogos que usam uma identidade gerenciada ou um Token de Acesso Pessoal (PAT) para autenticação, você deve atribuir uma identidade gerenciada para o projeto. Para catálogos que usam um PAT, você deve armazenar a PAT em um cofre de chaves e conceder à identidade gerenciada acesso ao segredo do cofre de chaves.

Configurar uma identidade gerida

Antes de anexar um catálogo a um centro de desenvolvimento ou projeto, você deve configurar uma identidade gerenciada, também chamada de Identidade de Serviço Gerenciado (MSI). Você pode anexar uma identidade gerenciada atribuída ao sistema (MSI atribuída pelo sistema) ou uma identidade gerenciada atribuída pelo usuário (MSI atribuída pelo usuário). Em seguida, você atribui funções à identidade gerenciada para permitir que o centro de desenvolvimento ou projeto crie tipos de ambiente em sua assinatura e leia o projeto Azure Repos que contém o repositório de catálogo.

Se o seu centro de desenvolvimento ou projeto não tiver um MSI anexado, siga as etapas em Configurar uma identidade gerenciada para criar uma e atribuir funções para a identidade gerenciada.

Para saber mais sobre identidades gerenciadas, consulte O que são identidades gerenciadas para recursos do Azure?

Adicionar um catálogo

Você pode adicionar um catálogo de um repositório do Azure Repos ou de um repositório do GitHub. Você pode optar por autenticar atribuindo permissões a um MSI ou usando um PAT, que você armazena em um cofre de chaves.

Selecione a guia para o tipo de repositório e autenticação que você deseja usar.

Azure Repos repo com MSI

Para adicionar um catálogo, conclua as seguintes tarefas:

• Atribua permissões no Azure Repos para a identidade gerenciada.
• Adicione seu repositório como um catálogo.

Atribuir permissões no Azure Repos para a identidade gerenciada

Você deve conceder as permissões de identidade gerenciada para o repositório no Azure Repos.

1. Entre na sua organização do Azure DevOps.

   Nota

   Sua organização do Azure DevOps deve estar no mesmo diretório que a assinatura do Azure que contém seu centro de desenvolvimento ou projeto.

2. Selecione Definições da organização.

   

3. Na página Visão geral, selecione Usuários.

   

4. Na página Usuários, selecione Adicionar usuários.

   

5. Conclua Adicionar novos usuários inserindo ou selecionando as seguintes informações e selecione Adicionar:

   Nome	Valor
   Usuários ou Entidades de Serviço	Insira o nome do seu centro de desenvolvimento ou projeto. Ao usar um MSI atribuído pelo sistema, especifique o nome do centro de desenvolvimento ou projeto, não o ID do objeto da conta gerenciada. Quando você usa um MSI atribuído pelo usuário, use o nome da conta gerenciada.
   Nível de acesso	Selecione Básico.
   Adicionar aos projetos	Selecione o projeto que contém seu repositório.
   Grupos de DevOps do Azure	Selecione Leitores de projeto.
   Enviar convites por e-mail (apenas para Utilizadores)	Desmarque a caixa de seleção.

   

Adicione seu repositório como um catálogo

Os Ambientes de Implantação do Azure dão suporte à anexação de repositórios do Azure Repos e repositórios do GitHub. Você pode armazenar um conjunto de modelos IaC selecionados em um repositório. Anexar o repositório a um centro de desenvolvimento ou projeto como um catálogo dá às suas equipes de desenvolvimento acesso aos modelos e permite que elas criem rapidamente ambientes consistentes.

As etapas a seguir permitem anexar um repositório do Azure Repos.

1. No portal do Azure, navegue até seu centro de desenvolvimento ou projeto.

2. No menu à esquerda, em Configuração do ambiente, selecione Catálogos e, em seguida, selecione Adicionar.

   

3. Em Adicionar catálogo, insira as seguintes informações e selecione Adicionar:

   Campo	Valor
   Nome	Insira um nome para o catálogo.
   Localização do catálogo	Selecione Azure DevOps.
   Tipo de autenticação	Selecione Identidade gerenciada.
   Organização	Selecione sua organização do Azure DevOps.
   Projeto	Na lista de projetos, selecione o projeto que armazena o repositório.
   Repositório	Na lista de repositórios, selecione o repositório que deseja adicionar.
   Ramo	Selecione a ramificação.
   Folder path	Dev Box recupera uma lista de pastas em sua ramificação. Selecione a pasta que armazena seus modelos IaC.

   

4. Em Catálogos do centro de desenvolvimento ou projeto, verifique se o catálogo aparece. Quando a conexão é bem-sucedida, o Status lê Sincronização bem-sucedida. A conexão com um catálogo pode levar alguns minutos na primeira vez.

Azure Repos repo com PAT

Para adicionar um catálogo, conclua as seguintes tarefas:

• Obtenha a URL de clone para seu repositório do Azure Repos.
• Crie um token de acesso pessoal (PAT).
• Armazene a PAT como um segredo do cofre de chaves no Cofre de Chaves do Azure.
• Adicione seu repositório como um catálogo.

Obter a URL de clone para seu repositório do Azure Repos

1. Vá para a página inicial da sua coleção de equipe (por exemplo, https://contoso-web-team.visualstudio.com) e selecione seu projeto.

2. Obtenha a URL de clone do seu repositório Git do Azure Repos.

3. Copie e salve o URL.

Criar um token de acesso pessoal no Azure Repos

1. Vá para a página inicial da sua coleção de equipe (por exemplo, https://contoso-web-team.visualstudio.com) e selecione seu projeto.

2. Crie um PAT.

3. Copie e salve o token gerado para usar mais tarde.

Criar um Key Vault

Você precisa de um Cofre da Chave do Azure para armazenar a PAT usada para conceder acesso do Azure ao seu repositório. Os cofres de chaves podem controlar o acesso com políticas de acesso ou RBAC (controle de acesso baseado em função). Se você tiver um cofre de chaves existente, poderá usá-lo, mas verifique se ele usa políticas de acesso ou atribuições RBAC para controlar o acesso. Para obter ajuda com a configuração de uma política de acesso para um cofre de chaves, consulte Atribuir uma política de acesso ao Cofre de Chaves.

Use as seguintes etapas para criar um cofre de chaves RBAC:

1. Inicie sessão no portal do Azure.

2. Na caixa Pesquisar, introduza Key Vault.

3. Na lista de resultados, selecione Cofre da Chave.

4. Na página Cofre da Chave, selecione Criar.

5. Na guia Criar cofre de chaves, forneça as seguintes informações:

   Nome	valor
   Nome	Insira um nome para o cofre de chaves.
   Subscrição	Selecione a subscrição na qual pretende criar o cofre de chaves.
   Grupo de recursos	Use um grupo de recursos existente ou selecione Criar novo e insira um nome para o grupo de recursos.
   Location	Selecione o local ou a região onde deseja criar o cofre de chaves.

   Deixe as outras opções em seus padrões.

6. No separador Política de acesso , selecione Controlo de acesso baseado na função do Azure e, em seguida, selecione Rever + criar.

7. No separador Rever + criar, selecione Criar.

Se as políticas da sua organização exigirem que mantenha o Cofre da Chave privado da Internet, pode definir o Cofre da Chave para permitir que os serviços fidedignos da Microsoft ignorem a regra de firewall.

Para saber como permitir que serviços confiáveis da Microsoft ignorem o firewall, consulte Configurar configurações de rede do Cofre da Chave do Azure.

Armazene o token de acesso pessoal no cofre de chaves

1. No Cofre da Chave, no menu à esquerda, selecione Segredos.

2. Na página Segredos, selecione Gerar/Importar.

3. Na página Criar um segredo:

   • Na caixa Nome, insira um nome descritivo para seu segredo.
   • Na caixa Valor secreto, cole a PAT copiada anteriormente.
   • Selecione Criar.

Obter o identificador secreto

Obtenha o caminho para o segredo que criou no cofre de chaves.

1. No portal do Azure, navegue até o cofre da chave.

2. Na página do cofre de chaves, no menu à esquerda, selecione Segredos.

3. Na página Segredos, selecione o segredo criado anteriormente.

4. Na página versões, selecione a VERSÃO ATUAL.

5. Na página da versão atual, para o identificador Secret, selecione copiar.

Adicione seu repositório como um catálogo

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

2. Certifique-se de que a identidade anexada ao centro de desenvolvimento ou projeto tenha acesso ao segredo do cofre de chaves onde seu token de acesso pessoal está armazenado.

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

4. Em Adicionar catálogo, insira as seguintes informações e selecione Adicionar:

   Campo	Valor
   Nome	Insira um nome para o catálogo.
   Localização do catálogo	Selecione Azure DevOps.
   Tipo de autenticação	Selecione Token de acesso pessoal.
   Organização	Selecione a organização que hospeda o repositório de catálogo.
   Projeto	Selecione o projeto que armazena o repositório de catálogo.
   Representante	Selecione o repositório que armazena o catálogo.
   Folder path	Selecione a pasta que contém seus modelos IaC.
   Identificador secreto	Introduza o identificador secreto que contém a sua PAT para o repositório. Quando você copia um identificador secreto, a cadeia de conexão inclui um identificador de versão no final, como neste exemplo: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. A remoção do identificador de versão garante que os Ambientes de Implantação busquem a versão mais recente do segredo no cofre de chaves. Se a sua PAT expirar, apenas o cofre das chaves terá de ser atualizado. Exemplo de identificador secreto: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Em Catálogos, verifique se o catálogo aparece. Se a conexão for bem-sucedida, o Status será Conectado.

Aplicativo DevCenter de repositório GitHub

Para adicionar um catálogo, conclua as seguintes tarefas:

1. Instalar e configurar o aplicativo Centro de Desenvolvimento da Microsoft
2. Atribua permissões no GitHub para os repositórios.
3. Adicione seu repositório como um catálogo.

Instalar o aplicativo Centro de Desenvolvimento da Microsoft

1. Inicie sessão no portal do Azure.

2. Navegue até o seu centro de desenvolvimento ou projeto.

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

4. No painel Adicionar catálogo, insira ou selecione o seguinte:

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

5. Para instalar o aplicativo Microsoft Dev Center, selecione 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 em Adicionar seu repositório como um catálogo.

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

    

Adicione seu repositório como um catálogo

1. Regresse ao portal do Azure.

2. Em 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. Em Catálogos, verifique se o catálogo aparece. Quando a conexão é bem-sucedida, o Status lê Sincronização bem-sucedida.

   

Repositório GitHub com PAT

Para adicionar um catálogo, conclua as seguintes tarefas:

• Obtenha a URL de clone do seu repositório GitHub.
• Crie um token de acesso pessoal (PAT) no GitHub.
• Armazene a PAT como um segredo do cofre de chaves no Cofre de Chaves do Azure.
• Adicione seu repositório como um catálogo.

Obter a URL de clone do seu repositório GitHub

1. Vá para a página inicial do repositório GitHub que contém as definições de modelo.

2. Obtenha a URL de clone do repositório GitHub.

3. Copie e salve o URL.

Criar um token de acesso pessoal no GitHub

Os Ambientes de Implantação do Azure dão suporte à autenticação em repositórios do GitHub usando tokens clássicos ou tokens refinados. Neste exemplo, você cria um token refinado.

1. Vá para a página inicial do repositório GitHub que contém as definições de modelo.

2. No canto superior direito do GitHub, selecione a imagem do perfil e, em seguida, selecione Configurações.

3. Na barra lateral esquerda, selecione Configurações do desenvolvedor>Tokens>de acesso pessoal Tokens refinados.

4. Selecione Gerar novo token.

5. Na página Novo token de acesso pessoal refinado, forneça as seguintes informações:

   Nome	Valor
   Nome do token	Insira um nome descritivo para o token.
   Validade	Selecione o período de expiração do token em dias.
   Descrição	Insira uma descrição para o token.
   Proprietário do recurso	Selecione o proprietário do repositório.
   Acesso ao repositório	Selecione Selecionar apenas repositórios.
   Selecionar repositórios	Selecione o repositório que contém as definições de ambiente.
   Permissões do repositório	Expanda Permissões do repositório e, para Conteúdo, na lista Acesso, selecione Código lido.

   

6. Selecione Gerar token.

7. Copie e salve o token gerado para usar mais tarde.

Importante

Ao trabalhar com um repositório privado armazenado em uma organização do GitHub, você deve garantir que a PAT do GitHub esteja configurada para dar acesso à organização correta e aos repositórios dentro dela.

• Os tokens clássicos dentro da organização devem ser SSO autorizados para a organização específica depois de serem criados.
• Os tokens refinados devem ter o proprietário do token definido como a própria organização a ser autorizada.

PATs configurados incorretamente podem resultar em um erro de repositório não encontrado .

Criar um Key Vault

Você precisa de um Cofre da Chave do Azure para armazenar a PAT usada para conceder acesso do Azure ao seu repositório. Os cofres de chaves podem controlar o acesso com políticas de acesso ou RBAC (controle de acesso baseado em função). Se você tiver um cofre de chaves existente, poderá usá-lo, mas verifique se ele usa políticas de acesso ou atribuições RBAC para controlar o acesso. Para obter ajuda com a configuração de uma política de acesso para um cofre de chaves, consulte Atribuir uma política de acesso ao cofre de chaves.

Use as seguintes etapas para criar um cofre de chaves RBAC:

1. Inicie sessão no portal do Azure.

2. Na caixa Pesquisar, insira o cofre da chave.

3. Na lista de resultados, selecione Cofre da Chave.

4. Na página Cofre da Chave, selecione Criar.

5. Na guia Criar cofre de chaves, forneça as seguintes informações:

   Nome	valor
   Nome	Insira um nome para o cofre de chaves.
   Subscrição	Selecione a subscrição na qual pretende criar o cofre de chaves.
   Grupo de recursos	Use um grupo de recursos existente ou selecione Criar novo e insira um nome para o grupo de recursos.
   Location	Selecione o local ou a região onde deseja criar o cofre de chaves.

   Deixe as outras opções em seus padrões.

6. No separador Política de acesso , selecione Controlo de acesso baseado na função do Azure e, em seguida, selecione Rever + criar.

7. No separador Rever + criar, selecione Criar.

Se as políticas da sua organização exigirem que mantenha o Cofre da Chave privado da Internet, pode definir o Cofre da Chave para permitir que os serviços fidedignos da Microsoft ignorem a regra de firewall.

Para saber como permitir que serviços confiáveis da Microsoft ignorem o firewall, consulte Configurar configurações de rede do Cofre da Chave do Azure.

Armazene o token de acesso pessoal no cofre de chaves

1. No Cofre da Chave, no menu à esquerda, selecione Segredos.

2. Na página Segredos, selecione Gerar/Importar.

3. Na página Criar um segredo:

   • Na caixa Nome, insira um nome descritivo para seu segredo.
   • Na caixa Valor secreto, cole o PAT.
   • Selecione Criar.

Obter o identificador secreto

Obtenha o caminho para o segredo que criou no cofre de chaves.

1. No portal do Azure, navegue até o cofre da chave.

2. Na página do cofre de chaves, no menu à esquerda, selecione Segredos.

3. Na página Segredos, selecione o segredo criado anteriormente.

4. Na página versões, selecione a VERSÃO ATUAL.

5. Na página da versão atual, para o identificador Secret, selecione copiar.

Adicione seu repositório como um catálogo

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

2. Certifique-se de que a identidade gerenciada anexada ao centro de desenvolvimento ou projeto tenha acesso ao segredo do cofre de chaves onde seu token de acesso pessoal está armazenado.

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

4. Em Adicionar catálogo, insira as seguintes informações e selecione Adicionar.

   Campo	Valor
   Nome	Insira um nome para o catálogo.
   Localização do catálogo	Selecione GitHub.
   Repositório	Insira ou cole a URL de clone do repositório do GitHub ou do repositório do Azure Repos. Exemplo de catálogo de exemplo: https://github.com/Azure/deployment-environments.git
   Ramo	Insira a ramificação do repositório à qual se conectar. Exemplo de catálogo de exemplo: main
   Folder path	Insira o caminho da pasta relativo ao URI de clone que contém subpastas que contêm suas definições de ambiente. O caminho da pasta é para a pasta com subpastas contendo arquivos de ambiente de definição de ambiente, não para a pasta com o próprio arquivo de ambiente de definição de ambiente. A imagem a seguir mostra a estrutura de pastas do catálogo de exemplo. Exemplo de catálogo de exemplo: /Environments O caminho da pasta pode começar com ou sem uma barra (/).
   Identificador secreto	Introduza o identificador secreto que contém a sua PAT para o repositório. Quando você copia um identificador secreto, a cadeia de conexão inclui um identificador de versão no final, como neste exemplo: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. A remoção do identificador de versão garante que os Ambientes de Implantação busquem a versão mais recente do segredo no cofre de chaves. Se a sua PAT expirar, apenas o cofre das chaves terá de ser atualizado. Exemplo de identificador secreto: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Em Catálogos, verifique se o catálogo aparece. Quando a conexão é bem-sucedida, o Status lê Sincronização bem-sucedida.

Exibir itens de catálogo sincronizados

Independentemente do tipo de repositório usado, você pode exibir os itens de catálogo que são sincronizados a partir do catálogo.

1. No menu à esquerda do seu centro de desenvolvimento ou projeto, em Configuração do ambiente, selecione Catálogos.

2. No painel Catálogos, selecione o nome do catálogo.

   

3. Você verá uma lista de itens de catálogo sincronizados com êxito.

   

Atualizar um catálogo

Se você atualizar a definição ou o conteúdo do modelo no repositório anexado, poderá fornecer o conjunto mais recente de definições de ambiente para suas equipes de desenvolvimento sincronizando o catálogo. Você pode sincronizar um catálogo manualmente ou automaticamente.

Sincronizar manualmente um catálogo

Quando você sincroniza manualmente um catálogo, os Ambientes de Implantação verificam o repositório e disponibilizam a lista mais recente de definições de ambiente para todos os projetos associados no centro de desenvolvimento.

1. No menu esquerdo do centro de desenvolvimento, em Configuração do ambiente, selecione Catálogos.

2. Selecione o catálogo específico e, na barra de comandos, selecione Sincronizar.

   

Sincronizar automaticamente um catálogo

Quando você configura um catálogo para sincronizar automaticamente, os Ambientes de Implantação verificam o repositório a cada 30 minutos e disponibilizam a lista mais recente de definições de ambiente para todos os projetos associados no centro de desenvolvimento.

1. No menu à esquerda do seu centro de desenvolvimento ou projeto, em Configuração do ambiente, selecione Catálogos.

2. Selecione o catálogo específico e, em seguida, selecione editar.

   

3. No painel Editar catálogo, selecione Sincronizar automaticamente este catálogo e, em seguida, selecione Guardar.

   

Excluir um catálogo

Você pode excluir um catálogo para removê-lo do centro de desenvolvimento ou projeto dos Ambientes de Implantação do Azure. Os modelos em um catálogo excluído não estão disponíveis para as equipes de desenvolvimento quando elas implantam novos ambientes. Atualize a referência de definição de ambiente para quaisquer ambientes existentes que foram criados usando as definições de ambiente no catálogo excluído. Se a referência não for atualizada e o ambiente for reimplantado, a implantação falhará.

Para excluir um catálogo:

1. No menu à esquerda do seu centro de desenvolvimento ou projeto, em Configuração do ambiente, selecione Catálogos.

2. Selecione o catálogo específico e, em seguida, selecione Excluir.

3. Na caixa de diálogo Excluir catálogo, selecione Continuar para excluir o catálogo.

Solucionar erros de sincronização de catálogo

Ao adicionar ou sincronizar um catálogo, você pode encontrar um erro ou aviso de sincronização. Um erro de sincronização indica que um catálogo falhou ao sincronizar com êxito, Um aviso de sincronização indica que alguns ou todos os itens do catálogo têm erros. Você pode exibir o status de sincronização e os erros no portal do Azure ou usar a CLI do Azure e a API REST para solucionar problemas e resolver os erros.

Exibir status de sincronização do catálogo

No portal do Azure, você pode obter mais informações sobre o status de sincronização do catálogo e quaisquer avisos ou erros selecionando o link de status. O link de status abre um painel que mostra o status da sincronização, o número de definições de ambiente que foram adicionadas e o número de definições de ambiente que foram ignoradas ou falharam.

Exibir falhas de sincronização do catálogo

1. No menu à esquerda do seu centro de desenvolvimento ou projeto, em Configuração do ambiente, selecione Catálogos.

2. Na coluna Status, selecione o link de status para o catálogo que falhou na sincronização.

   

3. Você verá um painel de detalhes que mostra as alterações na última sincronização, o número de erros de sincronização e o tipo de erros.

   

Ver avisos de sincronização de catálogo

1. No menu à esquerda do seu centro de desenvolvimento ou projeto, em Configuração do ambiente, selecione Catálogos.

2. Na coluna Status, selecione o link de status para o catálogo que sincronizou, mas relata um aviso.

   

3. Você verá um painel de detalhes que mostra as alterações na última sincronização, o número de erros de item e o tipo e a origem de cada erro.

   

4. Você pode exibir itens que foram sincronizados com êxito a partir de um catálogo que também relata erros de sincronização. No painel Catálogos, selecione o nome do catálogo.

   

5. Você verá uma lista de itens de catálogo sincronizados com êxito.

   

Solucionar erros de sincronização de catálogo usando a CLI do Azure

Use a CLI do Azure ou a API REST para OBTER o catálogo. A resposta GET mostra o tipo de erro:

• Definições de ambiente ignoradas que foram detetadas como duplicadas.
• Definições de ambiente inválidas que falharam devido a erros de esquema, referência ou validação.

Resolver erros de definição de ambiente ignorados

Um erro de definição de ambiente ignorado ocorre se você adicionar duas ou mais definições de ambiente que têm o mesmo nome. Você pode resolver esse problema renomeando as definições de ambiente para que cada definição de ambiente tenha um nome exclusivo dentro do catálogo.

Resolver erros de definição de ambiente inválidos

Um erro de definição de ambiente inválido pode ocorrer por vários motivos:

• Erros de esquema de manifesto. Certifique-se de que o arquivo de ambiente de definição de ambiente corresponda ao esquema necessário.

• Erros de validação Verifique os seguintes itens para resolver erros de validação:

  • Verifique se o tipo de mecanismo do arquivo de ambiente está configurado corretamente.
  • Verifique se o nome da definição do ambiente está entre 3 e 63 caracteres.
  • Certifique-se de que o nome da definição de ambiente inclua apenas caracteres válidos para uma URL, que são caracteres alfanuméricos e estes símbolos: ~ ! , . ' ; : = - _ + ( ) * & $ @

• Erros de referência. Certifique-se de que o caminho do modelo ao qual o arquivo de ambiente faz referência seja um caminho relativo válido para um arquivo no repositório.

Conteúdos relacionados

• Configurar tipos de ambiente para um centro de desenvolvimento
• Criar e configurar um projeto usando a CLI do Azure
• Configurar tipos de ambiente de projeto