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

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 Serviço de Aplicativo para se conectarem aos seus repositórios, um operador de nuvem deverá primeiro configurar a integração entre Serviço de Aplicativo no Azure Stack Hub e no 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 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.

   

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

   

Configurar o GitHub

Você deve ter uma conta do GitHub para concluir essa 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.

   

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

3. Insira a URL da Página Inicial. A URL da home page 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 para o aplicativo.

   

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 Serviço de Aplicativo provedor de recursos Administração 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. Clique em Salvar.

Configurar o BitBucket

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

1. Entre no BitBucket e acesse Integrações em sua conta.

   

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

   

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 a capitalização listada aqui.

6. Insira a 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: Leitura
   • Webhooks: leitura e gravação

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

   

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 Serviço de Aplicativo provedor de recursos Administração 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 Segredo na caixa de entrada Segredo do Cliente para BitBucket.

13. Clique em Salvar.

Configurar o OneDrive

Você deve ter uma conta da Microsoft vinculada a uma conta do OneDrive para concluir essa 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 para empresas.

1. https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade Acesse e entre usando sua conta 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 plataforma – Web e em uma implantação padrão do Azure Stack Hub, o URI de redirecionamento está no formulário – https://portal.<region>.<FQDN>/TokenAuthorize.

6. Selecione Registrar.

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

8. Em Certificados & segredos, escolha Segredos do Cliente e selecione Novo segredo do cliente. Forneça uma descrição e escolha o comprimento de expiração do 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 aspermissõ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 Serviço de Aplicativo provedor de recursos Administração 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 Segredo na caixa de entrada Segredo do Cliente do OneDrive.

16. Clique em Salvar.

Configurar o DropBox

Observação

Você deve ter uma conta do DropBox para concluir essa 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 entre usando suas credenciais de conta do DropBox.

2. Selecione Criar aplicativo.

   

3. Selecione API do DropBox.

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

5. Insira um Nome para seu aplicativo.

   

6. Selecione Criar Aplicativo. Você recebe uma página listando as configurações do aplicativo, incluindo a Chave de aplicativo e o Segredo do aplicativo.

7. Verifique se o nome da pasta 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.

   

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 Serviço de Aplicativo provedor de recursos Administração 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 segredo do aplicativo na caixa de entrada Segredo do Cliente para DropBox.

13. Clique em Salvar.

Importante

Se você estiver reconfigurando aplicativos existentes depois de atualizar para 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 essa 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.

   

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

3. Insira a URL da Página Inicial. A URL da home page 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 para o aplicativo.

   

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 Serviço de Aplicativo provedor de recursos Administração 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. Clique em Salvar.

Configurar o BitBucket

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

1. Entre no BitBucket e acesse Integrações em sua conta.

   

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

   

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 a capitalização listada aqui.

6. Insira a 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: Leitura
   • Webhooks: leitura e gravação

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

   

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 Serviço de Aplicativo provedor de recursos Administração 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 Segredo na caixa de entrada Segredo do Cliente para BitBucket.

13. Clique em Salvar.

Configurar o OneDrive

Você deve ter uma conta da Microsoft vinculada a uma conta do OneDrive para concluir essa 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 para empresas.

1. https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade Acesse e entre usando sua conta 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 plataforma – Web e em uma implantação padrão do Azure Stack Hub, o URI de redirecionamento está no formulário – https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callback.

6. Escolha Registrar

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

8. Em Certificados & segredos, escolha Segredos do Cliente e selecione Novo segredo do cliente. Forneça uma descrição e escolha o comprimento de expiração do 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 aspermissõ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 Serviço de Aplicativo provedor de recursos Administração 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 Segredo na caixa de entrada Segredo do Cliente do OneDrive.

16. Clique em Salvar.

Configurar o DropBox

Observação

Você deve ter uma conta do DropBox para concluir essa 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 entre usando suas credenciais de conta do DropBox.

2. Selecione Criar aplicativo.

   

3. Selecione API do DropBox.

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

5. Insira um Nome para seu aplicativo.

   

6. Selecione Criar Aplicativo. Você verá uma página listando as configurações do aplicativo, incluindo a Chave de 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.

   

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

10. Acesse Provedores de Recursos e selecione a Serviço de Aplicativo provedor de recursos Administração Serviço de Aplicativo.

11. Selecione Configuração do 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. Clique em Salvar.

Próximas etapas

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