Configurar origens de implementação para serviços de aplicações no Azure Stack Hub

Serviço de Aplicações no Azure Stack Hub suporta a implementação a pedido de vários fornecedores de controlo de origem. Esta funcionalidade permite que os programadores de aplicações implementem diretamente a partir dos repositórios de controlo de origem. Se os utilizadores quiserem configurar Serviço de Aplicações para se ligarem aos repositórios, um operador da cloud tem primeiro de configurar a integração entre Serviço de Aplicações no Azure Stack Hub e o fornecedor de controlo de origem.

Além do Git local, são suportados os seguintes fornecedores de controlo de origem:

• GitHub
• BitBucket
• OneDrive
• DropBox

Ver origens de implementação na administração do Serviço de Aplicações

1. Inicie sessão no portal de administrador do Azure Stack Hub como administrador de serviços.

2. Navegue até Todos os Serviços e selecione o Serviço de Aplicações.

   

3. Selecione Configuração do controlo de origem. Pode ver a lista de todas as origens de implementação configuradas.

   

Configurar o GitHub

Tem de ter uma conta do GitHub para concluir esta tarefa. Poderá querer utilizar uma conta para a sua organização em vez de uma conta pessoal.

1. Inicie sessão no GitHub, aceda a https://www.github.com/settings/developerse, em seguida, selecione Registar uma nova aplicação.

   

2. Introduza um Nome da aplicação. Por exemplo, Serviço de Aplicações no Azure Stack Hub.

3. Introduza o URL da Home page. O URL da Home page tem de ser o endereço do portal do Azure Stack Hub. Por exemplo, https://portal.<region>.<FQDN>. Para obter mais informações sobre o nome de domínio completamente qualificado (FQDN) do Azure Stack Hub, veja Espaço de nomes DNS do Azure Stack Hub.

4. Introduza uma Descrição da Aplicação.

5. Introduza o URL de chamada de retorno de autorização. Numa implementação predefinida do Azure Stack Hub, o URL está no formato https://portal.<region>.<FQDN>/TokenAuthorize.

6. Selecione Registar aplicação. É apresentada uma página a listar o ID de Cliente e o Segredo do Cliente da aplicação.

   

7. Num novo separador ou janela do browser, inicie sessão no portal de administrador do Azure Stack Hub como administrador de serviços.

8. Aceda a Fornecedores de Recursos e selecione a Administração fornecedor de recursos Serviço de Aplicações.

9. Selecione Configuração do controlo de origem.

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

11. Selecione Guardar.

Configurar o BitBucket

Tem de ter uma conta do BitBucket para concluir esta tarefa. Poderá querer utilizar uma conta para a sua organização em vez de uma conta pessoal.

1. Inicie sessão no BitBucket e aceda a Integrações na sua conta.

   

2. Selecione OAuth em Gestão de Acesso e Adicionar consumidor.

   

3. Introduza um Nome para o consumidor. Por exemplo, Serviço de Aplicações no Azure Stack Hub.

4. Introduza uma Descrição para a aplicação.

5. Introduza o URL de Chamada de Retorno. Numa implementação predefinida do Azure Stack Hub, o URL de chamada de retorno está no formato https://portal.<region>.<FQDN>/TokenAuthorize. Para que a integração do BitBucket seja bem-sucedida, o URL tem de seguir as maiúsculas/minúsculas listadas aqui.

6. Introduza o URL. Este URL deve ser o 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 escrita

8. Selecione Guardar. Agora, verá esta nova aplicação, juntamente com a Chave e o Segredo, em Consumidores de OAuth.

   

9. Num novo separador ou janela do browser, inicie sessão no portal de administrador do Azure Stack Hub como administrador de serviços.

10. Aceda a Fornecedores de Recursos e selecione a Administração fornecedor de recursos Serviço de Aplicações.

11. Selecione Configuração do controlo de origem.

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

13. Selecione Guardar.

Configurar o OneDrive

Tem de ter uma conta Microsoft associada a uma conta do OneDrive para concluir esta tarefa. Poderá querer utilizar uma conta para a sua organização em vez de uma conta pessoal.

Nota

Atualmente, as contas do OneDrive para empresas não são suportadas.

1. Aceda a https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade e inicie sessão com a sua conta Microsoft.

2. Em Registos de aplicações, selecione Novo registo.

3. Introduza um Nome para o novo registo de aplicações: por exemplo, introduza Serviço de Aplicações no Azure Stack Hub.

4. Em Tipos de conta suportados, selecione Apenas contas Microsoft pessoais.

5. Introduza o URI de Redirecionamento. Escolha plataforma – Web e, numa implementação predefinida do Azure Stack Hub, o URI de redirecionamento está no formulário – https://portal.<region>.<FQDN>/TokenAuthorize.

6. Selecione Registar.

7. O ecrã seguinte lista as propriedades da sua nova aplicação. Guarde o ID da Aplicação (cliente) numa localização temporária.

8. Em Certificados & segredos, selecione 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 as Permissões - Delegadas do Microsoft Graph.

    • Files.ReadWrite.AppFolder
    • Utilizador. Leitura

12. Num novo separador ou janela do browser, inicie sessão no portal de administrador do Azure Stack Hub como administrador de serviços.

13. Aceda a Fornecedores de Recursos e selecione a Administração fornecedor de recursos Serviço de Aplicações.

14. Selecione Configuração do controlo de origem.

15. Copie e cole o ID da Aplicação (cliente) na caixa de entrada ID de Cliente e Segredo na caixa de entrada Segredo do Cliente do OneDrive.

16. Selecione Guardar.

Configurar o DropBox

Nota

Tem de ter uma conta do DropBox para concluir esta tarefa. Poderá querer utilizar uma conta para a sua organização em vez de uma conta pessoal.

1. Aceda a https://www.dropbox.com/developers/apps e inicie sessão com as credenciais da conta DropBox.

2. Selecione Criar aplicação.

   

3. Selecione API do DropBox.

4. Defina o nível de acesso como Pasta de Aplicações.

5. Introduza um Nome para a sua aplicação.

   

6. Selecione Criar Aplicação. É-lhe apresentada uma página que lista as definições da aplicação, incluindo a Chave de aplicação e o Segredo da aplicação.

7. Certifique-se de que o nome da pasta Aplicação está definido para Serviço de Aplicações no Azure Stack Hub.

8. Defina o URI de Redirecionamento do OAuth 2 e, em seguida, selecione Adicionar. Numa implementação predefinida do Azure Stack Hub, o URI de redirecionamento está no formulário https://portal.<region>.<FQDN>/TokenAuthorize.

   

9. Num novo separador ou janela do browser, inicie sessão no portal de administrador do Azure Stack Hub como administrador do serviço.

10. Aceda a Fornecedores de Recursos e selecione o Serviço de Aplicações Fornecedor de Recursos Administração.

11. Selecione Configuração do controlo de origem.

12. Copie e cole a Chave de Aplicação na caixa de entrada ID do Cliente e segredo da aplicação na caixa de entrada Segredo do Cliente para DropBox.

13. Selecione Guardar.

Importante

Se estiver a reconfigurar as aplicações existentes depois de atualizar para Serviço de Aplicações do Azure no Azure Stack Hub 2022 H1, tem de revogar todos os tokens e os utilizadores finais terão de reautorizar com os fornecedores nas respetivas aplicações para permitir a sincronização de fornecedores de controlo de origem

Configurar o GitHub

Tem de ter uma conta do GitHub para concluir esta tarefa. Poderá querer utilizar uma conta para a sua organização em vez de uma conta pessoal.

1. Inicie sessão no GitHub, aceda a https://www.github.com/settings/developerse, em seguida, selecione Registar uma nova aplicação.

   

2. Introduza um Nome da aplicação. Por exemplo, Serviço de Aplicações no Azure Stack Hub.

3. Introduza o URL da Home page. O URL da Home page tem de ser o endereço do portal do Azure Stack Hub. Por exemplo, https://portal.<region>.<FQDN>. Para obter mais informações sobre o nome de domínio completamente qualificado (FQDN) do Azure Stack Hub, veja Espaço de nomes DNS do Azure Stack Hub.

4. Introduza uma Descrição da Aplicação.

5. Introduza o URL de chamada de retorno de autorização. Numa implementação predefinida do Azure Stack Hub, o URL encontra-se no formulário https://api.appservice.<region>.<FQDN>:44300/auth/github/callback.

6. Selecione Registar aplicação. É apresentada uma página a listar o ID de Cliente e o Segredo do Cliente da aplicação.

   

7. Num novo separador ou janela do browser, inicie sessão no portal de administrador do Azure Stack Hub como administrador do serviço.

8. Aceda a Fornecedores de Recursos e selecione o Serviço de Aplicações Fornecedor de Recursos Administração.

9. Selecione Configuração do controlo de origem.

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

11. Selecione Guardar.

Configurar o BitBucket

Tem de ter uma conta do BitBucket para concluir esta tarefa. Poderá querer utilizar uma conta para a sua organização em vez de uma conta pessoal.

1. Inicie sessão no BitBucket e aceda a Integrações na sua conta.

   

2. Selecione OAuth em Gestão de Acesso e Adicionar consumidor.

   

3. Introduza um Nome para o consumidor. Por exemplo, Serviço de Aplicações no Azure Stack Hub.

4. Introduza uma Descrição para a aplicação.

5. Introduza o URL de Chamada de Retorno. Numa implementação predefinida do Azure Stack Hub, o URL de chamada de retorno está no formulário https://api.appservice.<region>.<FQDN>:44300/auth/bitbucket/callback. Para que a integração do BitBucket seja bem-sucedida, o URL tem de seguir a capitalização listada aqui.

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

7. Selecione as Permissões necessárias :

   • Repositórios: Leitura
   • Webhooks: Ler e escrever

8. Selecione Guardar. Agora, verá esta nova aplicação, juntamente com a Chave e o Segredo, em Consumidores de OAuth.

   

9. Num novo separador ou janela do browser, inicie sessão no portal de administrador do Azure Stack Hub como administrador do serviço.

10. Aceda a Fornecedores de Recursos e selecione o Serviço de Aplicações Fornecedor de Recursos Administração.

11. Selecione Configuração do controlo de origem.

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

13. Selecione Guardar.

Configurar o OneDrive

Tem de ter uma conta Microsoft ligada a uma conta do OneDrive para concluir esta tarefa. Poderá querer utilizar uma conta para a sua organização em vez de uma conta pessoal.

Nota

Atualmente, as contas do OneDrive para empresas não são suportadas.

1. Aceda a https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade e inicie sessão com a sua conta Microsoft.

2. Em Registos de aplicações, selecione Novo registo.

3. Introduza um Nome para o novo registo de aplicações: por exemplo, introduza Serviço de Aplicações no Azure Stack Hub.

4. Em Tipos de conta suportados, selecione Apenas contas Microsoft pessoais

5. Introduza o URI de Redirecionamento. Escolha plataforma – Web e, numa implementação predefinida do Azure Stack Hub, o URI de redirecionamento está no formulário – https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callback.

6. Selecionar Registar

7. O ecrã seguinte lista as propriedades da sua nova aplicação. Guarde o ID da Aplicação (cliente) numa localização temporária.

8. Em Certificados & segredos, selecione 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. Tome nota do 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
    • Utilizador. Leitura

12. Num novo separador ou janela do browser, inicie sessão no portal de administrador do Azure Stack Hub como administrador do serviço.

13. Aceda a Fornecedores de Recursos e selecione o Serviço de Aplicações Fornecedor de Recursos Administração.

14. Selecione Configuração do controlo de origem.

15. Copie e cole o ID da Aplicação (cliente) na caixa de entrada ID de Cliente e Segredo na caixa de entrada Segredo do Cliente do OneDrive.

16. Selecione Guardar.

Configurar o DropBox

Nota

Tem de ter uma conta do DropBox para concluir esta tarefa. Poderá querer utilizar uma conta para a sua organização em vez de uma conta pessoal.

1. Aceda a https://www.dropbox.com/developers/apps e inicie sessão com as suas credenciais de conta do DropBox.

2. Selecione Criar aplicação.

   

3. Selecione API do DropBox.

4. Defina o nível de acesso como Pasta de Aplicações.

5. Introduza um Nome para a sua aplicação.

   

6. Selecione Criar Aplicação. É-lhe apresentada uma página que lista as definições da aplicação, incluindo a Chave de aplicação e o Segredo da aplicação.

7. Certifique-se de que o nome da pasta Aplicação está definido para Serviço de Aplicações no Azure Stack Hub.

8. Defina o URI de Redirecionamento do OAuth 2 e, em seguida, selecione Adicionar. Numa implementação predefinida do Azure Stack Hub, o URI de redirecionamento está no formulário https://api.appservice.<region>.<FQDN>:44300/auth/dropbox/callback.

   

9. Num novo separador ou janela do browser, inicie sessão no portal de administrador do Azure Stack Hub como administrador do serviço.

10. Aceda a Fornecedores de Recursos e selecione o Serviço de Aplicações Fornecedor de Recursos Administração.

11. Selecione Configuração do controlo de origem.

12. Copie e cole a Chave de Aplicação na caixa de entrada ID do Cliente e segredo da aplicação na caixa de entrada Segredo do Cliente para DropBox.

13. Selecione Guardar.

Passos seguintes

Os utilizadores podem agora utilizar as origens de implementação para aspetos como a implementação contínua, a implementação local do Git e a sincronização de pastas na cloud.