Configure deployment sources

Applies to: Azure Stack integrated systems and Azure Stack Development Kit

App Service on Azure Stack supports on-demand deployment from multiple source control providers. This feature lets application developers deploy direct from their source control repositories. 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 and the source control provider.

In addition to local Git, the following source control providers are supported:

  • GitHub
  • BitBucket
  • OneDrive
  • DropBox

View deployment sources in App Service administration

  1. Sign in to the Azure Stack Admin Portal (https://adminportal.local.azurestack.external) as the service administrator.
  2. Browse to Resource Providers and select the App Service Resource Provider Admin. App Service Resource Provider Admin
  3. Click Source control configuration. You can see the list of all configured deployment sources. App Service Resource Provider Admin Source Control Configuration

Configure GitHub

You must have a GitHub account to complete this task. You might want to use an account for your organization rather than a personal account.

  1. Sign in to GitHub, browse to https://www.github.com/settings/developers, and then click Register a new application. GitHub - Register a new application
  2. Enter an Application name; for example, App Service on Azure Stack.
  3. Enter the Homepage URL. The Homepage URL must be the Azure Stack portal address. For example, https://portal.local.azurestack.external.
  4. Enter an Application Description.
  5. Enter the Authorization callback URL. In a default Azure Stack deployment, the URL is in the form https://portal.local.azurestack.external/TokenAuthorize. If you are running under a different domain, substitute your domain name for local.azurestack.external.
  6. Click Register application. A page is displayed listing the Client ID and Client Secret for the application. GitHub - Completed application registration
  7. In a new browser tab or window, sign in to the Azure Stack admin portal (https://adminportal.local.azurestack.external) as the service administrator.
  8. Browse to Resource Providers, and select the App Service Resource Provider Admin.
  9. Click Source control configuration.
  10. Copy and paste the Client ID and Client Secret into the corresponding input boxes for GitHub.
  11. Click Save.

Configure BitBucket

You must have a BitBucket account to complete this task. You might want to use an account for your organization rather than a personal account.

  1. Sign in to BitBucket and browse to Integrations under your account. BitBucket Dashboard - Integrations
  2. Click OAuth under Access Management and Add consumer. BitBucket Add OAuth Consumer
  3. Enter a Name for the consumer; for example, App Service on Azure Stack.
  4. Enter a Description for the application.
  5. Enter the Callback URL. In a default Azure Stack deployment, the callback URL is in the form https://portal.local.azurestack.external/TokenAuthorize. If you are running under a different domain, substitute your domain name for azurestack.local. For BitBucket integration to succeed, the URL must follow the capitalization listed here.
  6. Enter the URL. This URL should be the Azure Stack portal URL; for example, https://portal.local.azurestack.external.
  7. Select the Permissions required:
    • Repositories: Read
    • Webhooks: Read and write
  8. Click Save. You now see this new application, along with the Key and Secret, under OAuth consumers. BitBucket Application Listing
  9. In a new browser tab or window, sign in to the Azure Stack admin portal (https://adminportal.local.azurestack.external) as the service administrator.
  10. Browse to Resource Providers and select the App Service Resource Provider Admin.
  11. Click Source control configuration.
  12. Copy and paste the Key into the Client ID input box and Secret into the Client Secret input box for BitBucket.
  13. Click Save.

Configure OneDrive

You must have a Microsoft Account linked to a OneDrive account to complete this task. You might want to use an account for your organization rather than a personal account.

Note

OneDrive for Business accounts are not currently supported.

  1. Browse to https://apps.dev.microsoft.com/?referrer=https%3A%2F%2Fdev.onedrive.com%2Fapp-registration.htm and sign in using your Microsoft Account.
  2. Under My applications, click Add an app. OneDrive Applications
  3. Enter a Name for the new application registration: enter App Service on Azure Stack, and then click Create Application
  4. The next screen lists the properties of your new application. Save the Application ID to some temporary location. OneDrive Application Properties
  5. Under Application Secrets, click Generate New Password. Make a note of the New password generated. This is your application secret and is not retrievable after you click OK.
  6. Under Platforms, click Add Platform, and then select Web.
  7. Enter the Redirect URI. In a default Azure Stack deployment, the Redirect URI is in the form https://portal.local.azurestack.external/TokenAuthorize. If you are running under a different domain, substitute your domain name for azurestack.local. OneDrive Application - Add Web Platform
  8. Add the Microsoft Graph Permissions - Delegated Permissions
    • Files.ReadWrite.AppFolder
    • User.Read
      OneDrive Application - Graph Permissions
  9. Click Save.
  10. In a new browser tab or window, sign in to the Azure Stack admin portal (https://adminportal.local.azurestack.external) as the service administrator.
  11. Browse to Resource Providers and select the App Service Resource Provider Admin.
  12. Click Source control configuration.
  13. Copy and paste the Application ID into the Client ID input box and Password into the Client Secret input box for OneDrive.
  14. Click Save.

Configure DropBox

Note

You must have a DropBox account to complete this task. You might want to use an account for your organization rather than a personal account.

  1. Browse to https://www.dropbox.com/developers/apps and sign in using your DropBox account credentials.
  2. Click Create app.

    Dropbox applications

  3. Select DropBox API.

  4. Set the access level to App Folder.
  5. Enter a Name for your application. Dropbox application registration
  6. Click Create App. You are presented with a page listing the settings for the app, including App key and App secret.
  7. Make sure that the App folder name is set to App Service on Azure Stack.
  8. Set the OAuth 2 Redirect URI and then click Add. In a default Azure Stack deployment, the Redirect URI is in the form https://portal.local.azurestack.external/TokenAuthorize. If you are running under a different domain, substitute your domain for azurestack.local. Dropbox application configuration
  9. In a new browser tab or window, sign in to the Azure Stack admin portal (https://adminportal.local.azurestack.external) as the service administrator.
  10. Browse to Resource Providers and select the App Service Resource Provider Admin.
  11. Click Source control configuration.
  12. Copy and paste the Application Key into the Client ID input box and App secret into the Client Secret input box for DropBox.
  13. Click Save.

Next steps

Users can now use the deployment sources for things like continuous deployment, local Git deployment, and cloud folder synchronization.