Konfigurieren von Bereitstellungsquellen für App Services in Azure Stack Hub

Artikel
07/29/2022
5 Minuten Lesedauer

App Service in Azure Stack Hub unterstützt die bedarfsgesteuerte Bereitstellung von mehreren Quellcodeverwaltungsanbietern. Dieses Feature ermöglicht App-Entwicklern eine Bereitstellung direkt aus ihren Repositorys zur Quellcodeverwaltung. Damit Benutzer App Service für das Herstellen einer Verbindung mit ihren Repositorys konfigurieren können, muss ein Cloudoperator zunächst die Integration zwischen App Service in Azure Stack Hub und dem Quellcodeverwaltungsanbieter konfigurieren.

Neben lokalem Git werden die folgenden Quellcodeverwaltungsanbieter unterstützt:

GitHub
BitBucket
OneDrive
Dropbox

Anzeigen der Bereitstellungsquellen in der App Service-Verwaltung

Melden Sie sich beim Azure Stack Hub-Administratorportal als Dienstadministrator an.
Navigieren Sie zu Alle Dienste, und wählen Sie den App Service aus.
Wählen Sie die Option Source control configuration (Konfiguration der Quellcodeverwaltung) aus. Die Liste aller konfigurierten Bereitstellungsquellen wird angezeigt.

Konfigurieren von GitHub

Sie benötigen ein GitHub-Konto, um diese Aufgabe abzuschließen. Möglicherweise möchten Sie lieber ein Konto für Ihre Organisation anstelle eines persönlichen Kontos verwenden.

Melden Sie sich bei GitHub an, navigieren Sie zu https://www.github.com/settings/developers, und wählen Sie dann Neue Anwendung registrieren aus.
Geben Sie unter Anwendungsname einen Namen ein. Beispiel: App Service unter Azure Stack Hub.
Geben Sie in Homepage URL die URL der Startseite ein. Die URL der Homepage muss die Adresse des Azure Stack Hub-Portals sein. Beispiel: https://portal.<region>.<FQDN>. Weitere Informationen zum vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) von Azure Stack Hub finden Sie unter DNS-Namespace von Azure Stack Hub.
Geben Sie in Application Description eine Anwendungsbeschreibung ein.
Geben Sie in Authorization callback URL die Autorisierungsrückruf-URL ein. In einer Standardbereitstellung von Azure Stack Hub weist die URL das Format https://portal.<region>.<FQDN>/TokenAuthorize auf.
Wählen Sie Anwendung registrieren aus. Nun wird eine Seite mit der Client-ID und dem geheimen Clientschlüssel für die App angezeigt.
Melden Sie sich im Browser auf einer neuen Registerkarte oder in einem neuen Fenster beim Azure Stack Hub-Administratorportal als Dienstadministrator an.
Navigieren Sie zu Resource Providers (Ressourcenanbieter), und wählen Sie App Service Resource Provider Admin (Administrator von App Service-Ressourcenanbieter) aus.
Wählen Sie die Option Source control configuration (Konfiguration der Quellcodeverwaltung) aus.
Kopieren Sie die Client-ID und das Clientgeheimnis, und fügen Sie sie in die entsprechenden Eingabefelder für GitHub ein.
Wählen Sie Speichern aus.

Konfigurieren von BitBucket

Sie benötigen ein Bitbucket-Konto, um diese Aufgabe abzuschließen. Möglicherweise möchten Sie lieber ein Konto für Ihre Organisation anstelle eines persönlichen Kontos verwenden.

Melden Sie sich bei Bitbucket an, und navigieren Sie unter Ihrem Konto zu Integrations (Integrationen).
Wählen Sie unter „Access Management“ (Zugriffsverwaltung) die Optionen OAuth und Add Consumer (Consumer hinzufügen) aus.
Geben Sie unter Name einen Namen für den Consumer ein. Beispiel: App Service unter Azure Stack Hub.
Geben Sie eine Beschreibung für die App ein.
Geben Sie in Callback URL die Rückruf-URL ein. In einer Standardbereitstellung von Azure Stack Hub weist die Rückruf-URL das Format https://portal.<region>.<FQDN>/TokenAuthorize auf. Die URL muss die hier aufgeführte Groß-/Kleinschreibung befolgen, damit die BitBucket-Integration erfolgreich ist.
Geben Sie die URL ein. Diese URL muss die Azure Stack Hub-Portal-URL sein. Beispiel: https://portal.<region>.<FQDN>.
Wählen Sie unter Permissions die erforderlichen Berechtigungen aus:
- Repositorys: Lesen
- Webhooks: Lesen und Schreiben
Wählen Sie Speichern aus. Unter OAuth consumers (OAuth-Consumer) wird diese neue App nun zusammen mit Key (Schlüssel) und Secret (Geheimnis) angezeigt.
Melden Sie sich im Browser auf einer neuen Registerkarte oder in einem neuen Fenster beim Azure Stack Hub-Administratorportal als Dienstadministrator an.
Navigieren Sie zu Resource Providers (Ressourcenanbieter), und wählen Sie App Service Resource Provider Admin (Administrator von App Service-Ressourcenanbieter) aus.
Wählen Sie die Option Source control configuration (Konfiguration der Quellcodeverwaltung) aus.
Kopieren Sie den Schlüssel und das Geheimnis, und fügen Sie sie in das Eingabefeld Client-ID bzw. das Eingabefeld Clientgeheimnis für BitBucket ein.
Wählen Sie Speichern aus.

Konfigurieren von OneDrive

Sie benötigen für diese Aufgabe ein mit einem OneDrive-Konto verknüpftes Microsoft-Konto. Möglicherweise möchten Sie lieber ein Konto für Ihre Organisation anstelle eines persönlichen Kontos verwenden.

Hinweis

OneDrive for Business-Konten werden derzeit nicht unterstützt.

Navigieren Sie zu https://apps.dev.microsoft.com/?referrer=https%3A%2F%2Fdev.onedrive.com%2Fapp-registration.htm, und melden Sie sich mit Ihrem Microsoft-Konto an.
Wählen Sie unter Meine Anwendungen die Option App hinzufügen aus.
Geben Sie für die neue App-Registrierung einen Namen wie App Service in Azure Stack Hub ein, und wählen Sie dann Anwendung erstellen aus.
Der nächste Bildschirm enthält die Eigenschaften der neuen App. Speichern Sie die Anwendungs-ID an einem temporären Speicherort.
Wählen Sie unter Anwendungsgeheimnisse die Option Neues Kennwort generieren aus. Notieren Sie sich das Kennwort unter Neues Kennwort wurde generiert. Dieses Kennwort ist Ihr Anwendungsgeheimnis. Es kann nicht mehr wiederhergestellt werden, nachdem Sie OK ausgewählt haben.
Wählen Sie unter Plattformen die Option Plattform hinzufügen und dann Web aus.
Geben Sie den Umleitungs-URI ein. In einer Standardbereitstellung von Azure Stack Hub weist der Umleitungs-URI das Format https://portal.<region>.<FQDN>/TokenAuthorize auf.
Fügen Sie Microsoft Graph-Berechtigungen - Delegierte Berechtigungen hinzu.
- Files.ReadWrite.AppFolder
- Benutzer Read
Wählen Sie Speichern aus.
Melden Sie sich im Browser auf einer neuen Registerkarte oder in einem neuen Fenster beim Azure Stack Hub-Administratorportal als Dienstadministrator an.
Navigieren Sie zu Resource Providers (Ressourcenanbieter), und wählen Sie App Service Resource Provider Admin (Administrator von App Service-Ressourcenanbieter) aus.
Wählen Sie die Option Source control configuration (Konfiguration der Quellcodeverwaltung) aus.
Kopieren Sie die Anwendungs-ID und das Kennwort, und fügen Sie sie in das Eingabefeld Client-ID bzw. das Eingabefeld Clientgeheimnis für OneDrive ein.
Wählen Sie Speichern aus.

Konfigurieren von Dropbox

Hinweis

Sie benötigen ein Dropbox-Konto, um diese Aufgabe abschließen zu können. Möglicherweise möchten Sie lieber ein Konto für Ihre Organisation anstelle eines persönlichen Kontos verwenden.

Navigieren Sie zu https://www.dropbox.com/developers/apps, und melden Sie sich mit den Anmeldeinformationen Ihres Dropbox-Kontos an.
Wählen Sie App erstellen aus.
Wählen Sie Dropbox API aus.
Legen Sie die Zugriffsebene auf App Folder (App-Ordner) fest.
Geben Sie einen Namen für Ihre App ein.
Wählen Sie App erstellen aus. Es wird eine Seite mit den Einstellungen für die App angezeigt, z. B. App key (App-Schlüssel) und App secret (App-Geheimnis).
Stellen Sie sicher, dass App folder name (Name des App-Ordners) auf App Service in Azure Stack Hub festgelegt ist.
Legen Sie den OAuth 2 Redirect URI (OAuth 2-Umleitungs-URI) fest, und wählen Sie dann Add (Hinzufügen) aus. In einer Standardbereitstellung von Azure Stack Hub weist der Umleitungs-URI das Format https://portal.<region>.<FQDN>/TokenAuthorize auf.
Melden Sie sich im Browser auf einer neuen Registerkarte oder in einem neuen Fenster beim Azure Stack Hub-Administratorportal als Dienstadministrator an.
Navigieren Sie zu Resource Providers (Ressourcenanbieter), und wählen Sie App Service Resource Provider Admin (Administrator von App Service-Ressourcenanbieter) aus.
Wählen Sie die Option Source control configuration (Konfiguration der Quellcodeverwaltung) aus.
Kopieren Sie die Werte von Application Key (Anwendungsschlüssel) und von App secret (App-Geheimnis), und fügen Sie sie in das Eingabefeld Client-ID bzw. das Eingabefeld Clientgeheimnis für Dropbox ein.
Wählen Sie Speichern aus.

Nächste Schritte

Benutzer können jetzt die Bereitstellungsquellen unter anderem für Continuous Deployment, lokale Git-Bereitstellungen und die Synchronisierung von Cloudordnern verwenden.