Compartilhar via


Automatizar as implantações do portal do desenvolvedor

APLICA-SE A: Desenvolvedor | Básico | Standard | Premium

O portal do desenvolvedor no Gerenciamento de API do Azure dá suporte ao acesso programático ao conteúdo. O portal do desenvolvedor permite que você importe ou exporte dados de um serviço de Gerenciamento de API por meio da API REST de gerenciamento de conteúdo. O acesso à API REST funciona para portais de desenvolvedor gerenciados e auto-hospedados.

Script de migração automatizada

Você pode automatizar a migração de conteúdo entre dois serviços de Gerenciamento de API, por exemplo, um serviço no ambiente de teste e um serviço no ambiente de produção. O scripts.v3/migrate.js script no repositório GitHub do portal do desenvolvedor simplifica esse processo de automação.

Aviso

O script remove o conteúdo do portal do desenvolvedor em seu serviço de Gerenciamento de API de destino. Se você estiver preocupado com isso, faça um backup.

Observação

O uso do script para migrar o conteúdo do portal do desenvolvedor entre uma instância do Gerenciamento de API em um nível clássico (por exemplo, Standard) e uma instância em um nível v2 (por exemplo, Standard v2) não tem suporte no momento. A migração de conteúdo do portal entre instâncias nos níveis v2 também não tem suporte.

Observação

Se você estiver usando um portal de desenvolvedor auto-hospedado com uma conta de armazenamento personalizada definida explicitamente para hospedar arquivos de mídia (ou seja, definir a blobStorageUrl configuração no config.design.json arquivo de configuração), será necessário usar o script originalscripts.v3/migrate.js. O script original não funciona para portais gerenciados ou auto-hospedados com a conta de armazenamento de mídia administrada pelo Gerenciamento de API. Nesse caso, use o script da pasta /scripts.v3.

O script executa as seguintes etapas:

  1. Captura o conteúdo do portal e a mídia do serviço de Gerenciamento de API de origem.
  2. Remove o conteúdo e a mídia do portal do serviço de Gerenciamento de API de destino.
  3. Carrega o conteúdo e a mídia do portal para o serviço de Gerenciamento de API de destino.
  4. Opcionalmente e somente para portais gerenciados: publica automaticamente o portal.

Depois que o script for executado com êxito, o serviço de Gerenciamento de API de destino deverá conter o mesmo conteúdo do portal que o serviço de origem e você poderá vê-lo como um administrador.

  • Se você estiver usando um portal gerenciado, poderá definir o script para publicar automaticamente o portal de destino para disponibilizar a versão migrada automaticamente para os visitantes.
  • Se você estiver usando um portal auto-hospedado, será necessário publicar o portal de destino manualmente. Siga as instruções de publicação e hospedagem no tutorial para configurar um portal de desenvolvedor auto-hospedado.