Compartilhar via

Configurar fontes de implantação para Serviços de Aplicativos no Azure Stack Hub

  • Artigo

O Serviço de Aplicativo no Azure Stack Hub dá suporte à implantação sob demanda de vários provedores de controle do código-fonte. Esse recurso permite que os desenvolvedores de aplicativos implantem diretamente de seus repositórios de controle do código-fonte. Se os usuários quiserem configurar o Serviço de Aplicativo para se conectar a seus repositórios, um operador de nuvem deverá primeiro configurar a integração entre o Serviço de Aplicativo no Azure Stack Hub e o provedor de controle do código-fonte.

Além do Git local, há suporte para os seguintes provedores de controle do código-fonte:

  • GitHub
  • BitBucket
  • OneDrive
  • DropBox

Exibir fontes de implantação na administração do Serviço de Aplicativo

  1. Entre no portal de administrador do Azure Stack Hub como um administrador de serviço.

  2. Navegue até Todos os Serviços e selecione o Serviço de Aplicativo.

    Administrador do provedor de recursos do Serviço de Aplicativo

  3. Selecione Configuração de controle do código-fonte. Você pode ver a lista de todas as fontes de implantação configuradas.

    Configuração de controle do código-fonte do administrador do provedor de recursos do Serviço de Aplicativo

Configurar o GitHub

Você deve ter uma conta do GitHub para concluir esta tarefa. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.

  1. Entre no GitHub, acesse https://www.github.com/settings/developerse selecione Registrar um novo aplicativo.

    GitHub - Registrar um novo aplicativo

  2. Insira um Nome de aplicativo. Por exemplo, Serviço de Aplicativo no Azure Stack Hub.

  3. Insira a URL da Home Page. A URL da página inicial deve ser o endereço do portal do Azure Stack Hub. Por exemplo, https://portal.<region>.<FQDN>. Para obter mais informações sobre o FQDN (nome de domínio totalmente qualificado) do Azure Stack Hub, consulte Namespace DNS do Azure Stack Hub.

  4. Insira uma Descrição do Aplicativo.

  5. Insira a URL de retorno de chamada de autorização. Em uma implantação padrão do Azure Stack Hub, a URL está no formato https://portal.<region>.<FQDN>/TokenAuthorize.

  6. Selecione Registrar aplicativo. Uma página é exibida listando a ID do cliente e o segredo do cliente do aplicativo.

    GitHub - Registro de aplicativo concluído

  7. Em uma nova guia ou janela do navegador, entre no portal do administrador do Azure Stack Hub como administrador do serviço.

  8. Vá para Provedores de Recursos e selecione o Administrador do Provedor de Recursos do Serviço de Aplicativo.

  9. Selecione Configuração de controle do código-fonte.

  10. Copie e cole a ID do Cliente e o Segredo do Cliente nas caixas de entrada correspondentes do GitHub.

  11. Selecione Salvar.

Configurar o BitBucket

Você deve ter uma conta BitBucket para concluir esta tarefa. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.

  1. Faça login no BitBucket e vá para Integrações em sua conta.

    BitBucket Dashboard - Integrações

  2. Selecione OAuth em Gerenciamento de acesso e Adicionar consumidor.

    BitBucket Adicionar consumidor OAuth

  3. Insira um Nome para o consumidor. Por exemplo, Serviço de Aplicativo no Azure Stack Hub.

  4. Insira uma Descrição para o aplicativo.

  5. Insira a URL de Retorno de Chamada. Em uma implantação padrão do Azure Stack Hub, a URL de retorno de chamada está no formato https://portal.<region>.<FQDN>/TokenAuthorize. Para que a integração do BitBucket seja bem-sucedida, a URL deve seguir as letras maiúsculas listadas aqui.

  6. Insira o URL. Essa URL deve ser a URL do portal do Azure Stack Hub. Por exemplo, https://portal.<region>.<FQDN>.

  7. Selecione as permissões necessárias:

    • Repositórios: Leia
    • Webhooks: leitura e gravação

  8. Selecione Salvar. Agora você vê esse novo aplicativo, juntamente com a Chave e o Segredo, em Consumidores OAuth.

    Listagem de aplicativos do BitBucket

  9. Em uma nova guia ou janela do navegador, entre no portal do administrador do Azure Stack Hub como administrador do serviço.

  10. Vá para Provedores de Recursos e selecione o Administrador do Provedor de Recursos do Serviço de Aplicativo.

  11. Selecione Configuração de controle do código-fonte.

  12. Copie e cole a Chave na caixa de entrada ID do Cliente e o Segredo na caixa de entrada Segredo do Cliente do BitBucket.

  13. Selecione Salvar.

Configurar o OneDrive

Você deve ter uma conta da Microsoft vinculada a uma conta do OneDrive para concluir esta tarefa. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.

Observação

No momento, não há suporte para contas do OneDrive for Business.

  1. Vá para https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade e entre usando sua conta da Microsoft.

  2. Em Registros de aplicativo, selecione Novo registro.

  3. Insira um Nome para o novo registro de aplicativo: por exemplo, insira Serviço de Aplicativo no Azure Stack Hub.

  4. Em Tipos de conta com suporte, selecione Somente contas pessoais da Microsoft.

  5. Insira o URI de Redirecionamento. Escolha a plataforma – Web e, em uma implantação padrão do Azure Stack Hub, o URI de redirecionamento está no formato - https://portal.<region>.<FQDN>/TokenAuthorize.

  6. Selecione Registrar.

  7. A próxima tela lista as propriedades do seu novo aplicativo. Salve a ID do aplicativo (cliente) em um local temporário.

  8. Em Certificados e segredos, escolha Segredos do cliente e selecione Novo segredo do cliente. Forneça uma descrição e escolha a duração da expiração para o novo segredo e selecione Adicionar.

  9. Anote o valor do novo segredo.

  10. Em Permissões de API, selecione Adicionar uma permissão.

  11. Adicione as permissões delegadas de permissões - do Microsoft Graph.

    • Files.ReadWrite.AppFolder
    • Usuário. Ler

  12. Em uma nova guia ou janela do navegador, entre no portal do administrador do Azure Stack Hub como administrador do serviço.

  13. Vá para Provedores de Recursos e selecione o Administrador do Provedor de Recursos do Serviço de Aplicativo.

  14. Selecione Configuração de controle do código-fonte.

  15. Copie e cole a ID do Aplicativo (cliente) na caixa de entrada ID do Cliente e o Segredo na caixa de entrada Segredo do Cliente do OneDrive.

  16. Selecione Salvar.

Configurar o DropBox

Observação

Você deve ter uma conta do DropBox para concluir esta tarefa. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.

  1. https://www.dropbox.com/developers/apps Acesse e faça login usando as credenciais da sua conta do DropBox.

  2. Selecione Criar aplicativo.

    Aplicativos do Dropbox

  3. Selecione API do DropBox.

  4. Defina o nível de acesso como Pasta do aplicativo.

  5. Insira um Nome para seu aplicativo.

    Registro do aplicativo Dropbox

  6. Selecione Criar Aplicativo. Você verá uma página listando as configurações do aplicativo, incluindo a chave do aplicativo e o segredo do aplicativo.

  7. Verifique se o nome da pasta do aplicativo está definido como Serviço de Aplicativo no Azure Stack Hub.

  8. Defina o URI de redirecionamento do OAuth 2 e selecione Adicionar. Em uma implantação padrão do Azure Stack Hub, o URI de redirecionamento está no formato https://portal.<region>.<FQDN>/TokenAuthorize.

    Configuração do aplicativo do Dropbox

  9. Em uma nova guia ou janela do navegador, entre no portal do administrador do Azure Stack Hub como administrador do serviço.

  10. Vá para Provedores de Recursos e selecione o Administrador do Provedor de Recursos do Serviço de Aplicativo.

  11. Selecione Configuração de controle do código-fonte.

  12. Copie e cole a chave do aplicativo na caixa de entrada ID do cliente e o segredo do aplicativo na caixa de entrada Segredo do cliente do DropBox.

  13. Selecione Salvar.

Importante

Se você estiver reconfigurando aplicativos existentes após atualizar para o Serviço de Aplicativo do Azure no Azure Stack Hub 2022 H1, deverá revogar todos os tokens e os usuários finais precisarão reautorizar com os provedores em seus aplicativos para habilitar a sincronização de provedores de controle do código-fonte

Configurar o GitHub

Você deve ter uma conta do GitHub para concluir esta tarefa. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.

  1. Entre no GitHub, acesse https://www.github.com/settings/developerse selecione Registrar um novo aplicativo.

    GitHub - Registrar um novo aplicativo

  2. Insira um Nome de aplicativo. Por exemplo, Serviço de Aplicativo no Azure Stack Hub.

  3. Insira a URL da Home Page. A URL da página inicial deve ser o endereço do portal do Azure Stack Hub. Por exemplo, https://portal.<region>.<FQDN>. Para obter mais informações sobre o FQDN (nome de domínio totalmente qualificado) do Azure Stack Hub, consulte Namespace DNS do Azure Stack Hub.

  4. Insira uma Descrição do Aplicativo.

  5. Insira a URL de retorno de chamada de autorização. Em uma implantação padrão do Azure Stack Hub, a URL está no formato https://api.appservice.<region>.<FQDN>:44300/auth/github/callback.

  6. Selecione Registrar aplicativo. Uma página é exibida listando a ID do cliente e o segredo do cliente do aplicativo.

    GitHub - Registro de aplicativo concluído

  7. Em uma nova guia ou janela do navegador, entre no portal do administrador do Azure Stack Hub como administrador do serviço.

  8. Vá para Provedores de Recursos e selecione o Administrador do Provedor de Recursos do Serviço de Aplicativo.

  9. Selecione Configuração de controle do código-fonte.

  10. Copie e cole a ID do Cliente e o Segredo do Cliente nas caixas de entrada correspondentes do GitHub.

  11. Selecione Salvar.

Configurar o BitBucket

Você deve ter uma conta BitBucket para concluir esta tarefa. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.

  1. Faça login no BitBucket e vá para Integrações em sua conta.

    BitBucket Dashboard - Integrações

  2. Selecione OAuth em Gerenciamento de acesso e Adicionar consumidor.

    BitBucket Adicionar consumidor OAuth

  3. Insira um Nome para o consumidor. Por exemplo, Serviço de Aplicativo no Azure Stack Hub.

  4. Insira uma Descrição para o aplicativo.

  5. Insira a URL de Retorno de Chamada. Em uma implantação padrão do Azure Stack Hub, a URL de retorno de chamada está no formato https://api.appservice.<region>.<FQDN>:44300/auth/bitbucket/callback. Para que a integração do BitBucket seja bem-sucedida, a URL deve seguir as letras maiúsculas listadas aqui.

  6. Insira o URL. Essa URL deve ser a URL do portal do Azure Stack Hub. Por exemplo, https://portal.<region>.<FQDN>.

  7. Selecione as permissões necessárias:

    • Repositórios: Leia
    • Webhooks: leitura e gravação

  8. Selecione Salvar. Agora você vê esse novo aplicativo, juntamente com a Chave e o Segredo, em Consumidores OAuth.

    Listagem de aplicativos do BitBucket

  9. Em uma nova guia ou janela do navegador, entre no portal do administrador do Azure Stack Hub como administrador do serviço.

  10. Vá para Provedores de Recursos e selecione o Administrador do Provedor de Recursos do Serviço de Aplicativo.

  11. Selecione Configuração de controle do código-fonte.

  12. Copie e cole a Chave na caixa de entrada ID do Cliente e o Segredo na caixa de entrada Segredo do Cliente do BitBucket.

  13. Selecione Salvar.

Configurar o OneDrive

Você deve ter uma conta da Microsoft vinculada a uma conta do OneDrive para concluir esta tarefa. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.

Observação

No momento, não há suporte para contas do OneDrive for Business.

  1. Vá para https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade e entre usando sua conta da Microsoft.

  2. Em Registros de aplicativo, selecione Novo registro.

  3. Insira um Nome para o novo registro de aplicativo: por exemplo, insira Serviço de Aplicativo no Azure Stack Hub.

  4. Em Tipos de conta com suporte, selecione Somente contas pessoais da Microsoft

  5. Insira o URI de Redirecionamento. Escolha a plataforma – Web e, em uma implantação padrão do Azure Stack Hub, o URI de redirecionamento está no formato - https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callback.

  6. Escolha Registrar

  7. A próxima tela lista as propriedades do seu novo aplicativo. Salve a ID do aplicativo (cliente) em um local temporário.

  8. Em Certificados e segredos, escolha Segredos do cliente e selecione Novo segredo do cliente. Forneça uma descrição e escolha a duração da expiração para o novo segredo e selecione Adicionar.

  9. Anote o valor do novo segredo.

  10. Em Permissões de API, selecione Adicionar uma permissão

  11. Adicione as permissões delegadas de permissões - do Microsoft Graph.

    • Files.ReadWrite.AppFolder
    • Usuário. Ler

  12. Em uma nova guia ou janela do navegador, entre no portal do administrador do Azure Stack Hub como administrador do serviço.

  13. Vá para Provedores de Recursos e selecione o Administrador do Provedor de Recursos do Serviço de Aplicativo.

  14. Selecione Configuração de controle do código-fonte.

  15. Copie e cole a ID do Aplicativo (cliente) na caixa de entrada ID do Cliente e o Segredo na caixa de entrada Segredo do Cliente do OneDrive.

  16. Selecione Salvar.

Configurar o DropBox

Observação

Você deve ter uma conta do DropBox para concluir esta tarefa. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.

  1. https://www.dropbox.com/developers/apps Acesse e faça login usando as credenciais da sua conta do DropBox.

  2. Selecione Criar aplicativo.

    Aplicativos do Dropbox

  3. Selecione API do DropBox.

  4. Defina o nível de acesso como Pasta do aplicativo.

  5. Insira um Nome para seu aplicativo.

    Registro do aplicativo Dropbox

  6. Selecione Criar Aplicativo. Você verá uma página listando as configurações do aplicativo, incluindo a chave do aplicativo e o segredo do aplicativo.

  7. Verifique se o nome da pasta do aplicativo está definido como Serviço de Aplicativo no Azure Stack Hub.

  8. Defina o URI de redirecionamento do OAuth 2 e selecione Adicionar. Em uma implantação padrão do Azure Stack Hub, o URI de redirecionamento está no formato https://api.appservice.<region>.<FQDN>:44300/auth/dropbox/callback.

    Configuração do aplicativo do Dropbox

  9. Em uma nova guia ou janela do navegador, entre no portal do administrador do Azure Stack Hub como administrador do serviço.

  10. Vá para Provedores de Recursos e selecione o Administrador do Provedor de Recursos do Serviço de Aplicativo.

  11. Selecione Configuração de controle do código-fonte.

  12. Copie e cole a chave do aplicativo na caixa de entrada ID do cliente e o segredo do aplicativo na caixa de entrada Segredo do cliente do DropBox.

  13. Selecione Salvar.

Próximas etapas

Os usuários agora podem usar as fontes de implantação para coisas como implantação contínua, implantação local do Git e sincronização de pastas na nuvem.