Configurar fontes de implantação para serviços de aplicativos no Hub Azure StackConfigure deployment sources for App Services on Azure Stack Hub

O serviço de aplicativo no Hub de Azure Stack dá suporte à implantação sob demanda de vários provedores de controle do código-fonte.App Service on Azure Stack Hub supports on-demand deployment from multiple source control providers. Esse recurso permite que os desenvolvedores de aplicativos implantem diretamente de seus repositórios de controle do código-fonte.This feature lets app developers deploy directly from their source control repositories. Se os usuários desejarem configurar o serviço de aplicativo para se conectarem a seus repositórios, um operador de nuvem deverá primeiro configurar a integração entre o serviço de aplicativo no Hub Azure Stack e o provedor de controle do código-fonte.If users want to configure App Service to connect to their repositories, a cloud operator must first configure the integration between App Service on Azure Stack Hub and the source control provider.

Além do git local, há suporte para os seguintes provedores de controle do código-fonte:In addition to local Git, the following source control providers are supported:

  • GitHubGitHub
  • BitBucketBitBucket
  • OneDriveOneDrive
  • DropBoxDropBox

Exibir fontes de implantação na administração do serviço de aplicativoView deployment sources in App Service administration

  1. Entre no portal do administrador do hub de Azure Stack como o administrador do serviço.Sign in to the Azure Stack Hub administrator portal as the service admin.

  2. Navegue até todos os serviços e selecione o serviço de aplicativo.Browse to All Services and select the App Service.

    Administrador do provedor de recursos do serviço de aplicativo

  3. Selecione configuração de controle do código-fonte.Select Source control configuration. Você pode ver a lista de todas as fontes de implantação configuradas.You can see the list of all configured deployment sources.

    Configuração de controle de origem do administrador do provedor de recursos do serviço de aplicativo

Configurar o GitHubConfigure GitHub

Você deve ter uma conta do GitHub para concluir esta tarefa.You must have a GitHub account to complete this task. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.You might want to use an account for your organization rather than a personal account.

  1. Entre no GitHub, vá para https://www.github.com/settings/developers e, em seguida, selecione registrar um novo aplicativo.Sign in to GitHub, go to https://www.github.com/settings/developers, and then select Register a new application.

    GitHub-registrar um novo aplicativo

  2. Insira um nome de aplicativo.Enter an Application name. Por exemplo, o serviço de aplicativo no Hub Azure Stack.For example, App Service on Azure Stack Hub.

  3. Insira a URL da Home Page.Enter the Homepage URL. A URL da Home Page deve ser o endereço do portal do Hub Azure Stack.The Homepage URL must be the Azure Stack Hub portal address. Por exemplo, https://portal.<region>.<FQDN>.For example, https://portal.<region>.<FQDN>. Para obter mais informações sobre o FQDN (nome de domínio totalmente qualificado) do Hub Azure Stack, consulte namespace de DNS do hub Azure Stack.For more information on the Azure Stack Hub fully qualified domain name (FQDN), see Azure Stack Hub DNS namespace.

  4. Insira uma Descrição do aplicativo.Enter an Application Description.

  5. Insira a URL de retorno de chamada de autorização.Enter the Authorization callback URL. Em uma implantação de Hub de Azure Stack padrão, a URL está no formato https://portal.<region>.<FQDN>/TokenAuthorize .In a default Azure Stack Hub deployment, the URL is in the form https://portal.<region>.<FQDN>/TokenAuthorize.

  6. Selecione registrar aplicativo.Select Register application. Uma página é exibida listando a ID do cliente e o segredo do cliente para o aplicativo.A page is displayed listing the Client ID and Client Secret for the app.

    GitHub - Registro de aplicativo concluído

  7. Em uma nova janela ou guia do navegador, entre no portal do administrador do hub de Azure Stack como o administrador do serviço.In a new browser tab or window, sign in to the Azure Stack Hub administrator portal as the service admin.

  8. Vá para provedores de recursos e selecione o administrador do provedor de recursos do serviço de aplicativo.Go to Resource Providers and select the App Service Resource Provider Admin.

  9. Selecione configuração de controle do código-fonte.Select Source control configuration.

  10. Copie e cole a ID do cliente e o segredo do cliente nas caixas de entrada correspondentes para o github.Copy and paste the Client ID and Client Secret into the corresponding input boxes for GitHub.

  11. Clique em Salvar.Select Save.

Configurar o BitBucketConfigure BitBucket

Você deve ter uma conta do BitBucket para concluir esta tarefa.You must have a BitBucket account to complete this task. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.You might want to use an account for your organization rather than a personal account.

  1. Entre no BitBucket e acesse as integrações em sua conta.Sign in to BitBucket and go to Integrations under your account.

    Painel BitBucket – integrações

  2. Selecione OAuth em gerenciamento de acesso e Adicionar consumidor.Select OAuth under Access Management and Add consumer.

    BitBucket adicionar consumidor OAuth

  3. Insira um nome para o consumidor.Enter a Name for the consumer. Por exemplo, o serviço de aplicativo no Hub Azure Stack.For example, App Service on Azure Stack Hub.

  4. Insira uma Descrição para o aplicativo.Enter a Description for the app.

  5. Insira a URL de Retorno de Chamada.Enter the Callback URL. Em uma implantação de Hub de Azure Stack padrão, a URL de retorno de chamada está no formato https://portal.<region>.<FQDN>/TokenAuthorize .In a default Azure Stack Hub deployment, the callback URL is in the form https://portal.<region>.<FQDN>/TokenAuthorize. Para que a integração do BitBucket seja realizada com sucesso, a URL deve seguir as letras maiúsculas listadas aqui.For BitBucket integration to succeed, the URL must follow the capitalization listed here.

  6. Insira a URL.Enter the URL. Essa URL deve ser a URL do portal do hub de Azure Stack.This URL should be the Azure Stack Hub portal URL. Por exemplo, https://portal.<region>.<FQDN>.For example, https://portal.<region>.<FQDN>.

  7. Selecione as permissões necessárias:Select the Permissions required:

    • Repositórios: leituraRepositories: Read
    • WebHooks: leitura e gravaçãoWebhooks: Read and write
  8. Clique em Salvar.Select Save. Agora, você verá esse novo aplicativo, junto com a chave e o segredo, em consumidores do OAuth.You now see this new app, along with the Key and Secret, under OAuth consumers.

    Listagem de aplicativos do BitBucket

  9. Em uma nova janela ou guia do navegador, entre no portal do administrador do hub de Azure Stack como o administrador do serviço.In a new browser tab or window, sign in to the Azure Stack Hub administrator portal as the service admin.

  10. Vá para provedores de recursos e selecione o administrador do provedor de recursos do serviço de aplicativo.Go to Resource Providers and select the App Service Resource Provider Admin.

  11. Selecione configuração de controle do código-fonte.Select Source control configuration.

  12. Copie e cole a chave na caixa de entrada ID do cliente e no segredo na caixa de entrada segredo do cliente para BitBucket.Copy and paste the Key into the Client ID input box and Secret into the Client Secret input box for BitBucket.

  13. Clique em Salvar.Select Save.

Configurar o OneDriveConfigure OneDrive

Você deve ter um conta Microsoft vinculado a uma conta do OneDrive para concluir esta tarefa.You must have a Microsoft account linked to a OneDrive account to complete this task. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.You might want to use an account for your organization rather than a personal account.

Observação

Atualmente, não há suporte para contas do OneDrive for Business.OneDrive for business accounts are currently not supported.

  1. Vá para https://apps.dev.microsoft.com/?referrer=https%3A%2F%2Fdev.onedrive.com%2Fapp-registration.htm e entre usando seu conta Microsoft.Go to https://apps.dev.microsoft.com/?referrer=https%3A%2F%2Fdev.onedrive.com%2Fapp-registration.htm and sign in using your Microsoft account.

  2. Em meus aplicativos, selecione Adicionar um aplicativo.Under My applications, select Add an app.

    Aplicativos do OneDrive

  3. Insira um nome para o novo registro de aplicativo: insira serviço de aplicativo no Hub Azure Stack e, em seguida, selecione criar aplicativo.Enter a Name for the new app registration: enter App Service on Azure Stack Hub and then select Create Application.

  4. A próxima tela lista as propriedades do seu novo aplicativo.The next screen lists the properties of your new app. Salve a ID do aplicativo em um local temporário.Save the Application ID to a temporary location.

    Propriedades do aplicativo OneDrive

  5. Em segredos do aplicativo, selecione gerar nova senha.Under Application Secrets, select Generate New Password. Anote a nova senha gerada.Make a note of the New password generated. Essa senha é o segredo do aplicativo e não é recuperável depois de selecionar OK.This password is your application secret and it's not retrievable after you select OK.

  6. Em plataformas, selecione Adicionar plataforma e, em seguida, selecione Web.Under Platforms, select Add Platform and then select Web.

  7. Insira o URI de Redirecionamento.Enter the Redirect URI. Em uma implantação de Hub de Azure Stack padrão, o URI de redirecionamento está no formato https://portal.<region>.<FQDN>/TokenAuthorize .In a default Azure Stack Hub deployment, the redirect URI is in the form https://portal.<region>.<FQDN>/TokenAuthorize.

    Aplicativo do OneDrive – adicionar plataforma da Web

  8. Adicione as Microsoft Graph Permissions - permissões delegadasde permissões de Microsoft Graph.Add the Microsoft Graph Permissions - Delegated Permissions.

    • Files.ReadWrite.AppFolderFiles.ReadWrite.AppFolder
    • Usuário. Ler  as permissões do grafo de aplicativo do onedriveUser. Read OneDrive Application - Graph Permissions
  9. Clique em Salvar.Select Save.

  10. Em uma nova janela ou guia do navegador, entre no portal do administrador do hub de Azure Stack como o administrador do serviço.In a new browser tab or window, sign in to the Azure Stack Hub administrator portal as the service admin.

  11. Vá para provedores de recursos e selecione o administrador do provedor de recursos do serviço de aplicativo.Go to Resource Providers and select the App Service Resource Provider Admin.

  12. Selecione configuração de controle do código-fonte.Select Source control configuration.

  13. Copie e cole a ID do aplicativo na caixa de entrada ID do cliente e a senha na caixa de entrada segredo do cliente para o onedrive.Copy and paste the Application ID into the Client ID input box and Password into the Client Secret input box for OneDrive.

  14. Clique em Salvar.Select Save.

Configurar o DropBoxConfigure DropBox

Observação

Você deve ter uma conta do DropBox para concluir esta tarefa.You must have a DropBox account to complete this task. Talvez você queira usar uma conta para sua organização em vez de uma conta pessoal.You might want to use an account for your organization rather than a personal account.

  1. Vá para https://www.dropbox.com/developers/apps e entre usando suas credenciais de conta do dropbox.Go to https://www.dropbox.com/developers/apps and sign in using your DropBox account credentials.

  2. Selecione Criar aplicativo.Select Create app.

    Aplicativos do Dropbox

  3. Selecione API do Dropbox.Select DropBox API.

  4. Defina o nível de acesso como pasta do aplicativo.Set the access level to App Folder.

  5. Insira um nome para seu aplicativo.Enter a Name for your app.

    Registro do aplicativo Dropbox

  6. Selecione criar aplicativo.Select Create App. Você verá uma página que lista as configurações do aplicativo, incluindo a chave do aplicativo e o segredo do aplicativo.You're presented with a page listing the settings for the app, including App key and App secret.

  7. Verifique se o nome da pasta do aplicativo está definido como serviço de aplicativo no Hub Azure Stack.Make sure that the App folder name is set to App Service on Azure Stack Hub.

  8. Defina o URI de redirecionamento OAuth 2 e, em seguida, selecione Adicionar.Set the OAuth 2 Redirect URI and then select Add. Em uma implantação de Hub de Azure Stack padrão, o URI de redirecionamento está no formato https://portal.<region>.<FQDN>/TokenAuthorize .In a default Azure Stack Hub deployment, the redirect URI is in the form https://portal.<region>.<FQDN>/TokenAuthorize.

    Configuração de aplicativo do Dropbox

  9. Em uma nova janela ou guia do navegador, entre no portal do administrador do hub de Azure Stack como o administrador do serviço.In a new browser tab or window, sign in to the Azure Stack Hub administrator portal as the service admin.

  10. Vá para provedores de recursos e selecione o administrador do provedor de recursos do serviço de aplicativo.Go to Resource Providers and select the App Service Resource Provider Admin.

  11. Selecione configuração de controle do código-fonte.Select Source control configuration.

  12. Copie e cole a chave do aplicativo na caixa de entrada ID do cliente e no segredo do aplicativo na caixa de entrada segredo do cliente para o dropbox.Copy and paste the Application Key into the Client ID input box and App secret into the Client Secret input box for DropBox.

  13. Clique em Salvar.Select Save.

Próximas etapasNext steps

Agora, os usuários podem usar as fontes de implantação para coisas como implantação contínua, implantação de git locale sincronização de pasta de nuvem.Users can now use the deployment sources for things like continuous deployment, local Git deployment, and cloud folder synchronization.