Udostępnij za pośrednictwem

Konfigurowanie źródeł wdrożenia dla usług App Services w usłudze Azure Stack Hub

  • Artykuł

App Service w usłudze Azure Stack Hub obsługuje wdrażanie na żądanie od wielu dostawców kontroli źródła. Ta funkcja umożliwia deweloperom aplikacji wdrażanie bezpośrednio z repozytoriów kontroli źródła. Jeśli użytkownicy chcą skonfigurować App Service do łączenia się ze swoimi repozytoriami, operator chmury musi najpierw skonfigurować integrację między App Service w usłudze Azure Stack Hub a dostawcą kontroli źródła.

Oprócz lokalnego narzędzia Git obsługiwane są następujące dostawcy kontroli źródła:

  • GitHub
  • BitBucket
  • OneDrive
  • Dropbox

Wyświetlanie źródeł wdrożenia w administracji App Service

  1. Zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  2. Przejdź do pozycji Wszystkie usługi i wybierz App Service.

    administrator dostawcy zasobów App Service

  3. Wybierz pozycję Konfiguracja kontroli źródła. Zostanie wyświetlona lista wszystkich skonfigurowanych źródeł wdrożenia.

    konfiguracja kontroli źródła administratora dostawcy zasobów App Service

Konfigurowanie usługi GitHub

Aby wykonać to zadanie, musisz mieć konto usługi GitHub. Możesz chcieć użyć konta dla organizacji, a nie konta osobistego.

  1. Zaloguj się do usługi GitHub, przejdź do https://www.github.com/settings/developerswitryny , a następnie wybierz pozycję Zarejestruj nową aplikację.

    GitHub — rejestrowanie nowej aplikacji

  2. Wprowadź nazwę aplikacji. Na przykład App Service w usłudze Azure Stack Hub.

  3. Wprowadź adres URL strony głównej. Adres URL strony głównej musi być adresem portalu usługi Azure Stack Hub. Na przykład https://portal.<region>.<FQDN>. Aby uzyskać więcej informacji na temat w pełni kwalifikowanej nazwy domeny (FQDN) usługi Azure Stack Hub, zobacz Przestrzeń nazw DNS usługi Azure Stack Hub.

  4. Wprowadź opis aplikacji.

  5. Wprowadź adres URL wywołania zwrotnego autoryzacji. W domyślnym wdrożeniu usługi Azure Stack Hub adres URL ma postać https://portal.<region>.<FQDN>/TokenAuthorize.

  6. Wybierz pozycję Zarejestruj aplikację. Zostanie wyświetlona strona zawierająca listę identyfikatorów klienta i klucza tajnego klienta dla aplikacji.

    GitHub — zakończona rejestracja aplikacji

  7. W nowej karcie lub oknie przeglądarki zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  8. Przejdź do pozycji Dostawcy zasobów i wybierz Administracja dostawcę zasobów App Service.

  9. Wybierz pozycję Konfiguracja kontroli źródła.

  10. Skopiuj i wklej identyfikator klienta i klucz tajny klienta do odpowiednich pól wejściowych dla usługi GitHub.

  11. Wybierz pozycję Zapisz.

Konfigurowanie rozwiązania BitBucket

Aby wykonać to zadanie, musisz mieć konto BitBucket. Możesz chcieć użyć konta dla organizacji, a nie konta osobistego.

  1. Zaloguj się do aplikacji BitBucket i przejdź do pozycji Integracje na swoim koncie .

    Pulpit nawigacyjny usługi BitBucket — integracje

  2. Wybierz pozycję OAuth w obszarze Zarządzanie dostępem i Dodaj konsumenta.

    BitBucket Add OAuth Consumer

  3. Wprowadź nazwę odbiorcy. Na przykład App Service w usłudze Azure Stack Hub.

  4. Wprowadź opis aplikacji.

  5. Wprowadź adres URL wywołania zwrotnego. W domyślnym wdrożeniu usługi Azure Stack Hub adres URL wywołania zwrotnego ma postać https://portal.<region>.<FQDN>/TokenAuthorize. Aby integracja z usługą BitBucket zakończyła się pomyślnie, adres URL musi być zgodny z literami wymienionymi tutaj.

  6. Wprowadź adres URL. Ten adres URL powinien być adresem URL portalu usługi Azure Stack Hub. Na przykład https://portal.<region>.<FQDN>.

  7. Wybierz wymagane uprawnienia :

    • Repozytoria: odczyt
    • Elementy webhook: odczyt i zapis

  8. Wybierz pozycję Zapisz. Ta nowa aplikacja jest teraz widoczna wraz z kluczem i wpisem tajnym w obszarze odbiorcy OAuth.

    Lista aplikacji BitBucket

  9. W nowej karcie lub oknie przeglądarki zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  10. Przejdź do pozycji Dostawcy zasobów i wybierz Administracja dostawcę zasobów App Service.

  11. Wybierz pozycję Konfiguracja kontroli źródła.

  12. Skopiuj i wklej klucz w polu wejściowym Identyfikator klienta i Wpis tajny w polu wejściowym Klucz tajny klienta dla usługi BitBucket.

  13. Wybierz pozycję Zapisz.

Konfigurowanie usługi OneDrive

Aby wykonać to zadanie, musisz mieć konto Microsoft połączone z kontem usługi OneDrive. Możesz chcieć użyć konta dla organizacji, a nie konta osobistego.

Uwaga

Konta usługi OneDrive dla firm nie są obecnie obsługiwane.

  1. Przejdź do strony https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade i zaloguj się przy użyciu konta Microsoft.

  2. W obszarze Rejestracje aplikacji wybierz pozycję Nowa rejestracja.

  3. Wprowadź nazwę nowej rejestracji aplikacji: na przykład wprowadź App Service w usłudze Azure Stack Hub.

  4. W obszarze Obsługiwane typy kont wybierz pozycję Tylko osobiste konta Microsoft.

  5. Wprowadź identyfikator URI przekierowania. Wybierz platformę — internet i w domyślnym wdrożeniu usługi Azure Stack Hub identyfikator URI przekierowania ma postać — https://portal.<region>.<FQDN>/TokenAuthorize.

  6. Wybierz pozycję Zarejestruj.

  7. Następny ekran zawiera listę właściwości nowej aplikacji. Zapisz identyfikator aplikacji (klienta) w lokalizacji tymczasowej.

  8. W obszarze Certyfikaty & wpisy tajne wybierz pozycję Wpisy tajne klienta i wybierz pozycję Nowy klucz tajny klienta. Podaj opis i wybierz długość wygaśnięcia nowego wpisu tajnego, a następnie wybierz pozycję Dodaj.

  9. Zanotuj wartość nowego wpisu tajnego.

  10. W obszarze Uprawnienia interfejsu API wybierz pozycję Dodaj uprawnienie.

  11. Dodajuprawnienia delegowaneprogramu - Microsoft Graph.

    • Files.ReadWrite.AppFolder
    • Użytkownika. Read

  12. W nowej karcie lub oknie przeglądarki zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  13. Przejdź do pozycji Dostawcy zasobów i wybierz Administracja dostawcę zasobów App Service.

  14. Wybierz pozycję Konfiguracja kontroli źródła.

  15. Skopiuj i wklej identyfikator aplikacji (klienta) w polu wejściowym Identyfikator klienta i Wpis tajny w polu wejściowym Klucz tajny klienta dla usługi OneDrive.

  16. Wybierz pozycję Zapisz.

Konfigurowanie aplikacji DropBox

Uwaga

Aby wykonać to zadanie, musisz mieć konto DropBox. Możesz chcieć użyć konta dla organizacji, a nie konta osobistego.

  1. Przejdź do strony https://www.dropbox.com/developers/apps i zaloguj się przy użyciu poświadczeń konta DropBox.

  2. Wybierz pozycję Utwórz aplikację.

    Aplikacje usługi Dropbox

  3. Wybierz pozycję DropBox API.

  4. Ustaw poziom dostępu na Folder aplikacji.

  5. Wprowadź nazwę aplikacji.

    Rejestracja aplikacji Dropbox

  6. Wybierz pozycję Utwórz aplikację. Zostanie wyświetlona strona zawierająca listę ustawień aplikacji, w tym klucz aplikacji i klucz tajny aplikacji.

  7. Upewnij się, że nazwa folderu aplikacji jest ustawiona na App Service w usłudze Azure Stack Hub.

  8. Ustaw identyfikator URI przekierowania OAuth 2 , a następnie wybierz pozycję Dodaj. W domyślnym wdrożeniu usługi Azure Stack Hub identyfikator URI przekierowania ma postać https://portal.<region>.<FQDN>/TokenAuthorize.

    Konfiguracja aplikacji Dropbox

  9. W nowej karcie lub oknie przeglądarki zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  10. Przejdź do pozycji Dostawcy zasobów i wybierz Administracja dostawcę zasobów App Service.

  11. Wybierz pozycję Konfiguracja kontroli źródła.

  12. Skopiuj i wklej klucz aplikacji w polu wejściowym Identyfikator klienta i Wpis tajny aplikacji w polu wejściowym Klucz tajny klienta dla pola DropBox.

  13. Wybierz pozycję Zapisz.

Ważne

Jeśli konfigurujesz ponownie istniejące aplikacje po uaktualnieniu do Azure App Service w usłudze Azure Stack Hub 2022 H1, musisz odwołać wszystkie tokeny, a użytkownicy końcowi będą musieli ponownie uwierzytelnić się z dostawcami w swoich aplikacjach, aby umożliwić synchronizację od dostawców kontroli źródła

Konfigurowanie usługi GitHub

Aby wykonać to zadanie, musisz mieć konto usługi GitHub. Możesz chcieć użyć konta dla organizacji, a nie konta osobistego.

  1. Zaloguj się do usługi GitHub, przejdź do https://www.github.com/settings/developerswitryny , a następnie wybierz pozycję Zarejestruj nową aplikację.

    GitHub — rejestrowanie nowej aplikacji

  2. Wprowadź nazwę aplikacji. Na przykład App Service w usłudze Azure Stack Hub.

  3. Wprowadź adres URL strony głównej. Adres URL strony głównej musi być adresem portalu usługi Azure Stack Hub. Na przykład https://portal.<region>.<FQDN>. Aby uzyskać więcej informacji na temat w pełni kwalifikowanej nazwy domeny (FQDN) usługi Azure Stack Hub, zobacz Przestrzeń nazw DNS usługi Azure Stack Hub.

  4. Wprowadź opis aplikacji.

  5. Wprowadź adres URL wywołania zwrotnego autoryzacji. W domyślnym wdrożeniu usługi Azure Stack Hub adres URL ma postać https://api.appservice.<region>.<FQDN>:44300/auth/github/callback.

  6. Wybierz pozycję Zarejestruj aplikację. Zostanie wyświetlona strona zawierająca listę identyfikatorów klienta i klucza tajnego klienta dla aplikacji.

    GitHub — zakończona rejestracja aplikacji

  7. W nowej karcie lub oknie przeglądarki zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  8. Przejdź do pozycji Dostawcy zasobów i wybierz Administracja dostawcę zasobów App Service.

  9. Wybierz pozycję Konfiguracja kontroli źródła.

  10. Skopiuj i wklej identyfikator klienta i klucz tajny klienta do odpowiednich pól wejściowych dla usługi GitHub.

  11. Wybierz pozycję Zapisz.

Konfigurowanie rozwiązania BitBucket

Aby wykonać to zadanie, musisz mieć konto BitBucket. Możesz chcieć użyć konta dla organizacji, a nie konta osobistego.

  1. Zaloguj się do aplikacji BitBucket i przejdź do pozycji Integracje na swoim koncie .

    Pulpit nawigacyjny usługi BitBucket — integracje

  2. Wybierz pozycję OAuth w obszarze Zarządzanie dostępem i Dodaj konsumenta.

    BitBucket Add OAuth Consumer

  3. Wprowadź nazwę odbiorcy. Na przykład App Service w usłudze Azure Stack Hub.

  4. Wprowadź opis aplikacji.

  5. Wprowadź adres URL wywołania zwrotnego. W domyślnym wdrożeniu usługi Azure Stack Hub adres URL wywołania zwrotnego ma postać https://api.appservice.<region>.<FQDN>:44300/auth/bitbucket/callback. Aby integracja z usługą BitBucket zakończyła się pomyślnie, adres URL musi być zgodny z literami wymienionymi tutaj.

  6. Wprowadź adres URL. Ten adres URL powinien być adresem URL portalu usługi Azure Stack Hub. Na przykład https://portal.<region>.<FQDN>.

  7. Wybierz wymagane uprawnienia :

    • Repozytoria: odczyt
    • Elementy webhook: odczyt i zapis

  8. Wybierz pozycję Zapisz. Ta nowa aplikacja jest teraz widoczna wraz z kluczem i wpisem tajnym w obszarze odbiorcy OAuth.

    Lista aplikacji BitBucket

  9. W nowej karcie lub oknie przeglądarki zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  10. Przejdź do pozycji Dostawcy zasobów i wybierz Administracja dostawcę zasobów App Service.

  11. Wybierz pozycję Konfiguracja kontroli źródła.

  12. Skopiuj i wklej klucz w polu wejściowym Identyfikator klienta i Wpis tajny w polu wejściowym Klucz tajny klienta dla usługi BitBucket.

  13. Wybierz pozycję Zapisz.

Konfigurowanie usługi OneDrive

Aby wykonać to zadanie, musisz mieć konto Microsoft połączone z kontem usługi OneDrive. Możesz chcieć użyć konta dla organizacji, a nie konta osobistego.

Uwaga

Konta usługi OneDrive dla firm nie są obecnie obsługiwane.

  1. Przejdź do strony https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade i zaloguj się przy użyciu konta Microsoft.

  2. W obszarze Rejestracje aplikacji wybierz pozycję Nowa rejestracja.

  3. Wprowadź nazwę nowej rejestracji aplikacji: na przykład wprowadź App Service w usłudze Azure Stack Hub.

  4. W obszarze Obsługiwane typy kont wybierz pozycję Osobiste konta Microsoft

  5. Wprowadź identyfikator URI przekierowania. Wybierz platformę — internet i w domyślnym wdrożeniu usługi Azure Stack Hub identyfikator URI przekierowania ma postać — https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callback.

  6. Wybierz pozycję Zarejestruj

  7. Następny ekran zawiera listę właściwości nowej aplikacji. Zapisz identyfikator aplikacji (klienta) w lokalizacji tymczasowej.

  8. W obszarze Certyfikaty & wpisy tajne wybierz pozycję Wpisy tajne klienta i wybierz pozycję Nowy klucz tajny klienta. Podaj opis i wybierz długość wygaśnięcia nowego wpisu tajnego, a następnie wybierz pozycję Dodaj.

  9. Zanotuj wartość nowego wpisu tajnego.

  10. W obszarze Uprawnienia interfejsu API wybierz pozycję Dodaj uprawnienie

  11. Dodajuprawnienia delegowaneprogramu - Microsoft Graph.

    • Files.ReadWrite.AppFolder
    • Użytkownika. Read

  12. W nowej karcie lub oknie przeglądarki zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  13. Przejdź do pozycji Dostawcy zasobów i wybierz Administracja dostawcę zasobów App Service.

  14. Wybierz pozycję Konfiguracja kontroli źródła.

  15. Skopiuj i wklej identyfikator aplikacji (klienta) w polu wejściowym Identyfikator klienta i Wpis tajny w polu wejściowym Klucz tajny klienta dla usługi OneDrive.

  16. Wybierz pozycję Zapisz.

Konfigurowanie aplikacji DropBox

Uwaga

Aby wykonać to zadanie, musisz mieć konto DropBox. Możesz chcieć użyć konta dla organizacji, a nie konta osobistego.

  1. Przejdź do strony https://www.dropbox.com/developers/apps i zaloguj się przy użyciu poświadczeń konta DropBox.

  2. Wybierz pozycję Utwórz aplikację.

    Aplikacje dropbox

  3. Wybierz pozycję DropBox API.

  4. Ustaw poziom dostępu na Folder aplikacji.

  5. Wprowadź nazwę aplikacji.

    Rejestracja aplikacji Dropbox

  6. Wybierz pozycję Utwórz aplikację. Zostanie wyświetlona strona zawierająca listę ustawień aplikacji, w tym klucz aplikacji i wpis tajny aplikacji.

  7. Upewnij się, że nazwa folderu aplikacji jest ustawiona na App Service w usłudze Azure Stack Hub.

  8. Ustaw identyfikator URI przekierowania OAuth 2 , a następnie wybierz pozycję Dodaj. W domyślnym wdrożeniu usługi Azure Stack Hub identyfikator URI przekierowania ma postać https://api.appservice.<region>.<FQDN>:44300/auth/dropbox/callback.

    Konfiguracja aplikacji Dropbox

  9. Na nowej karcie lub oknie przeglądarki zaloguj się do portalu administratora usługi Azure Stack Hub jako administrator usługi.

  10. Przejdź do pozycji Dostawcy zasobów i wybierz Administracja dostawcę zasobów App Service.

  11. Wybierz pozycję Konfiguracja kontroli źródła.

  12. Skopiuj i wklej klucz aplikacji w polu wejściowym Identyfikator klienta i Wpis tajny aplikacji w polu wejściowym Klucz tajny klienta dla pola DropBox.

  13. Wybierz pozycję Zapisz.

Następne kroki

Użytkownicy mogą teraz używać źródeł wdrażania, takich jak ciągłe wdrażanie, lokalne wdrażanie git i synchronizacja folderów w chmurze.