Azure Stack Hub 上の App Services のデプロイ ソースを構成する

  • [アーティクル]

App Service on Azure Stack Hub では、複数のソース管理プロバイダーからのオンデマンド デプロイがサポートされます。 この機能を使用して、アプリ開発者はソース管理リポジトリから直接デプロイできます。 App Service をリポジトリに接続するように構成するには、まず、クラウド オペレーターが App Service on Azure Stack Hub とソース管理プロバイダーの統合を構成する必要があります。

ローカル Git の他に、次のソース管理プロバイダーがサポートされます。

  • GitHub
  • BitBucket
  • OneDrive
  • DropBox

App Service 管理でデプロイ ソースを表示する

  1. サービス管理者として Azure Stack Hub 管理者ポータルにサインインします。

  2. [All Services (すべてのサービス)] を参照し、 [App Service] を選択します。

    App Service リソース プロバイダー管理

  3. [ソース管理の構成] を選択します。 構成されているすべてのデプロイ ソースの一覧が表示されます。

    App Service リソース プロバイダー管理のソース管理の構成

GitHub を構成する

このタスクを完了するには、GitHub アカウントが必要です。 個人のアカウントではなく、組織のアカウントを使用できます。

  1. GitHub にサインインし、 https://www.github.com/settings/developers に移動して、 [Register a new application]\(新しいアプリケーションの登録\) を選択します。

    GitHub - 新しいアプリケーションの登録

  2. アプリケーション名を入力します。 たとえば、App Service on Azure Stack Hub です。

  3. [Homepage URL (ホームページの URL)] を入力します。 ホームページの URL は、Azure Stack Hub ポータルのアドレスである必要があります。 たとえば、「 https://portal.<region>.<FQDN> 」のように入力します。 Azure Stack Hub の完全修飾ドメイン名 (FQDN) の詳細については、「Azure Stack Hub の DNS 名前空間」を参照してください。

  4. [アプリケーションの説明] .を入力します。

  5. [Authorization callback URL (認証コールバック エンドポイント URL)] を入力します。 既定の Azure Stack Hub デプロイでは、URL は https://portal.<region>.<FQDN>/TokenAuthorize という形式になります。

  6. [アプリケーションの登録] を選択します。 アプリの [クライアント ID] と [クライアント シークレット] を示すページが表示されます。

    GitHub - 完了したアプリケーション登録

  7. 新しいブラウザー タブまたはウィンドウで、Azure Stack Hub 管理者ポータルにサービス管理者としてサインインします。

  8. [リソースプロバイダー] に移動し、 [App Service Resource Provider Admin](App Service リソース プロバイダー管理) を選択します。

  9. [ソース管理の構成] を選択します。

  10. クライアント ID とクライアント シークレットをコピーして、GitHub 用の対応する入力ボックスに貼り付けます。

  11. [保存] を選択します。

BitBucket を構成する

このタスクを完了するには、BitBucket アカウントが必要です。 個人のアカウントではなく、組織のアカウントを使用できます。

  1. BitBucket にサインインし、アカウントの下の [Integrations (統合)] に移動します。

    BitBucket ダッシュボード - 統合

  2. [アクセス管理] で [OAuth] を選択し、 [Add consumer](コンシューマーの追加) を選択します。

    BitBucket への OAuth コンシューマーの追加

  3. コンシューマーの名前を入力します。 たとえば、App Service on Azure Stack Hub です。

  4. アプリの説明を入力します。

  5. [Callback URL (コールバック URL)] を入力します。 既定の Azure Stack Hub デプロイでは、コールバック URL は https://portal.<region>.<FQDN>/TokenAuthorize という形式になります。 BitBucket の統合を成功させるには、URL の大文字と小文字をここに示されているとおりにする必要があります。

  6. [URL] を入力します。 この URL は、Azure Stack Hub ポータルの URL にする必要があります。 たとえば、「 https://portal.<region>.<FQDN> 」のように入力します。

  7. 必要な [Permissions](権限) を次のように選択します。

    • リポジトリ: 読み取り
    • Webhooks: 読み取りと書き込み

  8. [保存] を選択します。 これで、この新しいアプリが [OAuth consumers](OAuth コンシューマー) の下に [キー] と [シークレット] と共に表示されます。

    BitBucket アプリケーション リスト

  9. 新しいブラウザー タブまたはウィンドウで、Azure Stack Hub 管理者ポータルにサービス管理者としてサインインします。

  10. [リソースプロバイダー] に移動し、 [App Service Resource Provider Admin](App Service リソース プロバイダー管理) を選択します。

  11. [ソース管理の構成] を選択します。

  12. キーをコピーして BitBucket 用の [クライアント ID] 入力ボックスに、シークレットをコピーして BitBucket 用の [クライアント シークレット] 入力ボックスに貼り付けます。

  13. [保存] を選択します。

OneDrive を構成する

このタスクを完了するには、OneDrive アカウントにリンクされている Microsoft アカウントが必要です。 個人のアカウントではなく、組織のアカウントを使用できます。

注意

現時点では、OneDrive for Business アカウントはサポートされていません。

  1. https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade に移動し、Microsoft アカウントを使用してサインインします。

  2. [アプリの登録] で、[新規登録] を選択します。

  3. 新しいアプリ登録の [名前] を入力します。たとえば、「Azure Stack Hub でApp Service」と入力します。

  4. [ サポートされているアカウントの種類] で、[ 個人用 Microsoft アカウントのみ] を選択します。

  5. [リダイレクト URI] を入力します。 [プラットフォーム ] - [Web] を選択し、既定の Azure Stack Hub デプロイでは、リダイレクト URI は という https://portal.<region>.<FQDN>/TokenAuthorize形式になります。

  6. [登録] を選択します。

  7. 次の画面に、新しいアプリのプロパティが表示されます。 アプリケーション (クライアント) ID を一時的な場所に保存します。

  8. [ 証明書 & シークレット] で、[ クライアント シークレット ] を選択し、[ 新しいクライアント シークレット] を選択します。 説明を入力し、新しいシークレットの有効期限の長さを選択し、[追加] を選択 します。

  9. 新しいシークレットの値をメモしておきます。

  10. [ API のアクセス許可] で、[ アクセス許可の追加] を選択します。

  11. [Microsoft Graph のアクセス許可] - [委任されたアクセス許可] を追加します。

    • Files.ReadWrite.AppFolder
    • ユーザー。 Read

  12. 新しいブラウザー タブまたはウィンドウで、Azure Stack Hub 管理者ポータルにサービス管理者としてサインインします。

  13. [リソースプロバイダー] に移動し、 [App Service Resource Provider Admin](App Service リソース プロバイダー管理) を選択します。

  14. [ソース管理の構成] を選択します。

  15. アプリケーション (クライアント) ID をコピーして[クライアント ID] 入力ボックスに貼り付け、[シークレット] を OneDrive の [クライアント シークレット] 入力ボックスに貼り付けます。

  16. [保存] を選択します。

DropBox を構成する

注意

このタスクを完了するには、DropBox アカウントが必要です。 個人のアカウントではなく、組織のアカウントを使用できます。

  1. https://www.dropbox.com/developers/apps に移動し、DropBox アカウントの資格情報を使用してサインインします。

  2. [Create app](アプリの作成) を選択します。

    Dropbox アプリ

  3. [Dropbox API] を選択します。

  4. アクセス レベルを [App folder](アプリ フォルダー) に設定します。

  5. アプリの名前を入力します。

    Dropbox アプリケーションの登録

  6. [Create app](アプリの作成) を選択します。 [アプリ キー] と [アプリケーション シークレット] を含む、アプリの設定を一覧表示するページが表示されます。

  7. [App folder name](アプリ フォルダー名) が [App Service on Azure Stack Hub] に設定されていることを確認します。

  8. [OAuth 2 Redirect URI](OAuth 2 リダイレクト URI) を設定し、 [Add](追加) を選択します。 既定の Azure Stack Hub デプロイでは、リダイレクト URI は https://portal.<region>.<FQDN>/TokenAuthorize という形式になります。

    Dropbox アプリケーションの構成

  9. 新しいブラウザー タブまたはウィンドウで、Azure Stack Hub 管理者ポータルにサービス管理者としてサインインします。

  10. [リソースプロバイダー] に移動し、 [App Service Resource Provider Admin](App Service リソース プロバイダー管理) を選択します。

  11. [ソース管理の構成] を選択します。

  12. アプリケーション キーをコピーして DropBox 用の [クライアント ID] 入力ボックスに、アプリ シークレットをコピーして DropBox 用の [クライアント シークレット] 入力ボックスに貼り付けます。

  13. [保存] を選択します。

重要

Azure Stack Hub 2022 H1 のAzure App Serviceにアップグレードした後に既存のアプリケーションを再構成する場合は、すべてのトークンを取り消す必要があります。エンド ユーザーは、ソース管理プロバイダーからの同期を有効にするために、アプリケーションのプロバイダーと再認証する必要があります

GitHub を構成する

このタスクを完了するには、GitHub アカウントが必要です。 個人のアカウントではなく、組織のアカウントを使用できます。

  1. GitHub にサインインし、 https://www.github.com/settings/developers に移動して、 [Register a new application]\(新しいアプリケーションの登録\) を選択します。

    GitHub - 新しいアプリケーションの登録

  2. アプリケーション名を入力します。 たとえば、App Service on Azure Stack Hub です。

  3. [Homepage URL (ホームページの URL)] を入力します。 ホームページの URL は、Azure Stack Hub ポータルのアドレスである必要があります。 たとえば、「 https://portal.<region>.<FQDN> 」のように入力します。 Azure Stack Hub の完全修飾ドメイン名 (FQDN) の詳細については、「Azure Stack Hub の DNS 名前空間」を参照してください。

  4. [アプリケーションの説明] .を入力します。

  5. [Authorization callback URL (認証コールバック エンドポイント URL)] を入力します。 既定の Azure Stack Hub デプロイでは、URL は https://api.appservice.<region>.<FQDN>:44300/auth/github/callback という形式になります。

  6. [アプリケーションの登録] を選択します。 アプリの [クライアント ID] と [クライアント シークレット] を示すページが表示されます。

    GitHub - 完了したアプリケーション登録

  7. 新しいブラウザー タブまたはウィンドウで、Azure Stack Hub 管理者ポータルにサービス管理者としてサインインします。

  8. [リソースプロバイダー] に移動し、 [App Service Resource Provider Admin](App Service リソース プロバイダー管理) を選択します。

  9. [ソース管理の構成] を選択します。

  10. クライアント ID とクライアント シークレットをコピーして、GitHub 用の対応する入力ボックスに貼り付けます。

  11. [保存] を選択します。

BitBucket を構成する

このタスクを完了するには、BitBucket アカウントが必要です。 個人のアカウントではなく、組織のアカウントを使用できます。

  1. BitBucket にサインインし、アカウントの下の [Integrations (統合)] に移動します。

    BitBucket ダッシュボード - 統合

  2. [アクセス管理] で [OAuth] を選択し、 [Add consumer](コンシューマーの追加) を選択します。

    BitBucket への OAuth コンシューマーの追加

  3. コンシューマーの名前を入力します。 たとえば、App Service on Azure Stack Hub です。

  4. アプリの説明を入力します。

  5. [Callback URL (コールバック URL)] を入力します。 既定の Azure Stack Hub デプロイでは、コールバック URL は https://api.appservice.<region>.<FQDN>:44300/auth/bitbucket/callback という形式になります。 BitBucket の統合を成功させるには、URL の大文字と小文字をここに示されているとおりにする必要があります。

  6. [URL] を入力します。 この URL は、Azure Stack Hub ポータルの URL にする必要があります。 たとえば、「 https://portal.<region>.<FQDN> 」のように入力します。

  7. 必要な [Permissions](権限) を次のように選択します。

    • リポジトリ: 読み取り
    • Webhooks: 読み取りと書き込み

  8. [保存] を選択します。 これで、この新しいアプリが [OAuth consumers](OAuth コンシューマー) の下に [キー] と [シークレット] と共に表示されます。

    BitBucket アプリケーション リスト

  9. 新しいブラウザー タブまたはウィンドウで、Azure Stack Hub 管理者ポータルにサービス管理者としてサインインします。

  10. [リソースプロバイダー] に移動し、 [App Service Resource Provider Admin](App Service リソース プロバイダー管理) を選択します。

  11. [ソース管理の構成] を選択します。

  12. キーをコピーして BitBucket 用の [クライアント ID] 入力ボックスに、シークレットをコピーして BitBucket 用の [クライアント シークレット] 入力ボックスに貼り付けます。

  13. [保存] を選択します。

OneDrive を構成する

このタスクを完了するには、OneDrive アカウントにリンクされている Microsoft アカウントが必要です。 個人のアカウントではなく、組織のアカウントを使用できます。

注意

現時点では、OneDrive for Business アカウントはサポートされていません。

  1. https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade に移動し、Microsoft アカウントを使用してサインインします。

  2. [アプリの登録] で、[新規登録] を選択します。

  3. 新しいアプリ登録の [名前] を入力します。たとえば、「Azure Stack Hub でApp Service」と入力します。

  4. [サポートされているアカウントの種類] で、[個人用 Microsoft アカウントのみ] を選択します

  5. [リダイレクト URI] を入力します。 [プラットフォーム ] - [Web] を選択し、既定の Azure Stack Hub デプロイでは、リダイレクト URI は という https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callback形式になります。

  6. [登録] を選択します

  7. 次の画面に、新しいアプリのプロパティが表示されます。 アプリケーション (クライアント) ID を一時的な場所に保存します。

  8. [ 証明書 & シークレット] で、[ クライアント シークレット ] を選択し、[ 新しいクライアント シークレット] を選択します。 説明を入力し、新しいシークレットの有効期限の長さを選択し、[追加] を選択 します。

  9. 新しいシークレットの値をメモしておきます。

  10. [API のアクセス許可] で、[アクセス許可の追加] を選択します。

  11. [Microsoft Graph のアクセス許可] - [委任されたアクセス許可] を追加します。

    • Files.ReadWrite.AppFolder
    • ユーザー。 Read

  12. 新しいブラウザー タブまたはウィンドウで、Azure Stack Hub 管理者ポータルにサービス管理者としてサインインします。

  13. [リソースプロバイダー] に移動し、 [App Service Resource Provider Admin](App Service リソース プロバイダー管理) を選択します。

  14. [ソース管理の構成] を選択します。

  15. アプリケーション (クライアント) ID をコピーして[クライアント ID] 入力ボックスに貼り付け、[シークレット] を OneDrive の [クライアント シークレット] 入力ボックスに貼り付けます。

  16. [保存] を選択します。

DropBox を構成する

注意

このタスクを完了するには、DropBox アカウントが必要です。 個人のアカウントではなく、組織のアカウントを使用できます。

  1. https://www.dropbox.com/developers/apps に移動し、DropBox アカウントの資格情報を使用してサインインします。

  2. [Create app](アプリの作成) を選択します。

    Dropbox アプリ

  3. [Dropbox API] を選択します。

  4. アクセス レベルを [App folder](アプリ フォルダー) に設定します。

  5. アプリの名前を入力します。

    Dropbox アプリケーションの登録

  6. [Create app](アプリの作成) を選択します。 [アプリ キー] と [アプリケーション シークレット] を含む、アプリの設定を一覧表示するページが表示されます。

  7. [App folder name](アプリ フォルダー名) が [App Service on Azure Stack Hub] に設定されていることを確認します。

  8. [OAuth 2 Redirect URI](OAuth 2 リダイレクト URI) を設定し、 [Add](追加) を選択します。 既定の Azure Stack Hub デプロイでは、リダイレクト URI は https://api.appservice.<region>.<FQDN>:44300/auth/dropbox/callback という形式になります。

    Dropbox アプリケーションの構成

  9. 新しいブラウザー タブまたはウィンドウで、Azure Stack Hub 管理者ポータルにサービス管理者としてサインインします。

  10. [リソースプロバイダー] に移動し、 [App Service Resource Provider Admin](App Service リソース プロバイダー管理) を選択します。

  11. [ソース管理の構成] を選択します。

  12. アプリケーション キーをコピーして DropBox 用の [クライアント ID] 入力ボックスに、アプリ シークレットをコピーして DropBox 用の [クライアント シークレット] 入力ボックスに貼り付けます。

  13. [保存] を選択します。

次のステップ

継続的配置、ローカルの Git デプロイ、クラウド フォルダーの同期などでデプロイ ソースを使用できるようになりました。