Sincronizar ativos de API de um repositório Git para Azure Centro de API

Este artigo descreve como integrar um repositório Git ao Centro de API Azure para sincronizar automaticamente ativos de API, como skills, agents e MCP servers em seu inventário de API. Ao conectar um repositório Git, você pode manter o inventário do centro de API atualizado sem registrar ou atualizar manualmente cada ativo.

Ao integrar um repositório Git:

Seu centro de API cria um ambiente que representa o repositório como uma fonte de ativos.
O Centro de API sincroniza regularmente as informações do ativo do repositório com o inventário do centro de API.

Pré-requisitos

Um centro de API. Se você ainda não tiver um centro de API, confira o início rápido para criar um centro de API.
Um repositório Git que contém os ativos que você deseja sincronizar.
Para repositórios não públicos, um PAT (token de acesso pessoal) para acessar o repositório. O PAT deve ter permissões apropriadas para ler o conteúdo do repositório. Para criar um PAT para GitHub, consulte Criar um token de acesso pessoal refinado.
Um cofre de chaves do Azure para armazenar o Token de Acesso Pessoal (PAT), se um for usado para acesso. Se você precisar criar um cofre de chaves, consulte Quickstart: Criar um cofre de chaves usando o portal Azure. Para adicionar ou gerenciar segredos no cofre de chaves, você precisa, pelo menos, da função Key Vault Secrets Officer ou de permissões equivalentes.
Para CLI do Azure:
- Use o ambiente bash em Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
- Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.
  - Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
  - Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.
  - Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.
Observação

Você pode executar exemplos de comando da CLI do Azure neste artigo no PowerShell ou em um shell bash. Sempre que necessário, devido às diferentes sintaxes variáveis, são fornecidos exemplos de comando separados para os dois shells.

Armazenar PAT no Azure Key Vault

Se o repositório Git for privado, carregue manualmente e armazene com segurança um PAT no Azure Key Vault que concede acesso ao repositório. Ao integrar o repositório Git ao centro de API, configure a integração para usar esse segredo.

Para saber mais, confira a página Início Rápido: definir e recuperar um segredo do Azure Key Vault usando o portal do Azure.

Se você não precisar configurar um PAT, prossiga para Integrar um repositório Git.

Configurar uma identidade gerenciada para o centro de API

Seu centro de API usa uma identidade gerenciada para autenticar no Azure Key Vault e recuperar o PAT necessário para acessar o repositório Git. Os procedimentos a seguir descrevem como configurar manualmente uma identidade gerenciada para o centro de API e atribuir as permissões necessárias para acessar o Key Vault.

Se você não configurar a identidade gerenciada, o Centro de API poderá configurá-la para você automaticamente ao integrar o repositório Git.

Para esse cenário, o Centro de APIs usa uma identidade gerenciada para acessar os recursos do Azure. Dependendo das suas necessidades, habilite uma identidade gerenciada atribuída pelo sistema ou uma ou mais identidades gerenciadas atribuídas pelo usuário.

Os exemplos a seguir mostram como habilitar uma identidade gerenciada atribuída pelo sistema usando o portal do Azure ou a CLI do Azure. A um nível elevado, os passos de configuração são semelhantes para uma identidade gerida atribuída pelo utilizador.

Portal
CLI do Azure

No portal, vá para o centro de API.
No menu da barra lateral, em Segurança, selecione Identidades gerenciadas.
Selecione Sistema atribuído e defina o status como Ativado.
Clique em Salvar.

Defina a identidade atribuída pelo sistema no centro de API usando o seguinte comando az apic update. Substitua os nomes do centro de API e do grupo de recursos:

az apic update --name <api-center-name> --resource-group <resource-group-name> --identity '{"type": "SystemAssigned"}'

Atribuir a função Key Vault Secrets User à identidade gerenciada

Para permitir a importação dos ativos, atribua à identidade gerenciada do centro de API a função Usuário de Segredos do Key Vault em seu cofre de chaves do Azure. É possível usar o portal ou a CLI do Azure.

Portal
CLI do Azure

No portal, acesse seu cofre de chaves.
No menu da barra lateral, selecione Controle de acesso (IAM).
Selecione + Adicionar atribuição de função.
Na página Adicionar atribuição de função, defina os valores da seguinte maneira:
1. Na guia Role, selecione Key Vault Secrets User.
2. Na guia Membros, em Atribuir acesso a – Selecione Identidade Gerenciada > + Selecionar membros.
3. Na página Selecionar identidades gerenciadas, selecione a identidade gerenciada atribuída pelo sistema ao Centro de APIs que você adicionou na seção anterior. Clique em Selecionar.
4. Selecione Examinar + atribuir.

Obtenha a ID da entidade de segurança da identidade. Para uma identidade atribuída pelo sistema, use o comando az apic show.

#! /bin/bash
apicObjID=$(az apic show --name <api-center-name> \
    --resource-group <resource-group-name> \
    --query "identity.principalId" --output tsv)

# Formatted for PowerShell
$apicObjID=$(az apic show --name <api-center-name> `
    --resource-group <resource-group-name> `
    --query "identity.principalId" --output tsv)

Obtenha a ID do recurso do seu cofre de chaves usando o comando az keyvault show.

#! /bin/bash
kvID=$(az keyvault show --name <kv-name> --resource-group <resource-group-name> --query "id" --output tsv)

# Formatted for PowerShell
$kvID=$(az keyvault show --name <kv-name> --resource-group <resource-group-name> --query "id" --output tsv)

Atribua a função Key Vault Secrets User à identidade gerenciada no seu cofre de chaves usando o comando az role assignment create.

#! /bin/bash
scope="${kvID:1}"

az role assignment create \
    --role "Key Vault Secrets User" \
    --assignee-object-id $apicObjID \
    --assignee-principal-type ServicePrincipal \
    --scope $scope

# Formatted for PowerShell
$scope=$apimID.substring(1)

az role assignment create `
    --role "Key Vault Secrets User" `
    --assignee-object-id $apicObjID `
    --assignee-principal-type ServicePrincipal `
    --scope $scope

Integrar um repositório Git

Para integrar um repositório Git:

No portal do Azure, vá para o centro de API.
No menu da barra lateral, selecione Plataformas>Integrações.
Selecione + Nova integração e escolha Do repositório Git.

Ao integrar seu repositório Git, insira as seguintes informações:

Campo	Descrição
Configurar a origem do repositório Git
URL do repositório	Insira a URL do repositório Git que contém arquivos de ativos. Opcionalmente, especifique o ramo e a subpasta (por exemplo, `https://github.com/<org>/<repo>/tree/main/skills`).
Provedor Git	Selecione o provedor (por exemplo, GitHub).
Configuração do tipo de ativo	O API Center configura um tipo de recurso de habilidade padrão com o padrão de arquivo `/skill.md`. Selecione + Adicionar tipo de ativo** para adicionar um ou mais tipos de ativos para sincronizar.
PAT (token de acesso pessoal)	Se você tiver um PAT armazenado no Azure Key Vault, clique em Selecionar para navegar até o segredo do Key Vault. Opcionalmente, selecione Configurar automaticamente a identidade gerenciada e atribuir permissões se você não configurou manualmente uma identidade gerenciada para acessar o segredo do cofre de chaves.
Detalhes da integração	Aceite o identificador de link gerado ou forneça uma ID personalizada para o link de integração.
Detalhes do ambiente
Título do ambiente	Insira um nome amigável para o ambiente do repositório (por exemplo, repositório Git).
Identificação	Insira um nome de recurso de ambiente (por exemplo, git-repositório).
Tipo de ambiente	Selecione o tipo de ambiente (por exemplo, Produção).
Description	Opcionalmente, adicione uma descrição para o ambiente.
Detalhes do ativo
Ciclo de vida	Selecione o estágio do ciclo de vida dos ativos sincronizados no repositório (por exemplo, Design).

Selecione Criar.

O portal integra o ambiente ao centro de API. O portal adiciona os ativos do repositório ao inventário do centro de API na páginaAtivos de >. Você pode identificar ativos vinculados pelo ícone de link na lista.

Captura de tela dos recursos vinculados no Centro de API do portal.

Comentários

Esta página foi útil?

Last updated on 2026-06-01