Condividi tramite

Configurare le origini di distribuzione per i Servizi app nell’hub di Azure Stack

  • Articolo

Servizio App nell'Hub di Azure Stack supporta la distribuzione su richiesta da più provider di controllo del codice sorgente. Questa funzionalità consente agli sviluppatori di app di distribuire direttamente dai repository di controllo del codice sorgente. Se gli utenti vogliono configurare servizio app per connettersi ai repository, un operatore cloud deve prima configurare l'integrazione tra servizio app nell'hub di Azure Stack e il provider di controllo del codice sorgente.

Oltre a Git locale, sono supportati i provider di controllo del codice sorgente seguenti:

  • GitHub
  • BitBucket
  • OneDrive
  • DropBox

Visualizza le origini di distribuzione nell'amministrazione di App Service

  1. Accedere al portale dell'amministratore dell'hub di Azure Stack come amministratore del servizio.

  2. Passare a Tutti i servizi e selezionare il servizio app.

    amministratore del provider di risorse App Service

  3. Selezionare Configurazione del controllo del codice sorgente. È possibile visualizzare l'elenco di tutte le origini di distribuzione configurate.

    configurazione del controllo del codice sorgente per l'amministratore del provider di risorse di App Service

Configurare GitHub

Per completare questa attività, è necessario disporre di un account GitHub. È possibile usare un account per l'organizzazione anziché un account personale.

  1. Accedere a GitHub, passare a https://www.github.com/settings/developerse quindi selezionare Registra una nuova applicazione.

    GitHub - Registrare una nuova applicazione

  2. Immettere un Nome applicazione. Ad esempio, servizio app nell'hub di Azure Stack.

  3. Immettere l'URL della homepage. L'URL della home page deve essere l'indirizzo del portale dell'hub di Azure Stack. Ad esempio: https://portal.<region>.<FQDN>. Per altre informazioni sul nome di dominio completo (FQDN) dell'hub di Azure Stack, vedere Spazio dei nomi DNS dell'hub di Azure Stack.

  4. Immettere una descrizione dell'applicazione.

  5. Immettere l'URL di callback di autorizzazione. In una distribuzione predefinita dell'hub di Azure Stack, l'URL è nel formato https://portal.<region>.<FQDN>/TokenAuthorize.

  6. Selezionare Registra applicazione. Viene visualizzata una pagina che elenca l'ID cliente e il segreto cliente per l'app.

    GitHub - Registrazione applicazione completata

  7. In una nuova scheda o finestra del browser accedere al portale di amministrazione dell'hub di Azure Stack come amministratore del servizio.

  8. Passare a Provider di risorse e selezionare Amministratore del provider di risorse per i servizi app.

  9. Selezionare Configurazione del controllo del codice sorgente.

  10. Copia e incolla l'ID Client e il Client Secret nelle caselle di input corrispondenti per GitHub.

  11. Seleziona Salva.

Configurare BitBucket

Per completare questa attività, è necessario disporre di un account BitBucket. È possibile usare un account per l'organizzazione anziché un account personale.

  1. Accedi a BitBucket e vai a Integrazioni sotto al tuo account.

    Dashboard di BitBucket - Integrazioni

  2. Selezionare OAuth in Gestione degli accessi e Aggiungi consumer.

    BitBucket Add OAuth Consumer

  3. Immettere un Nome per l'utente. Ad esempio, servizio app nell'hub di Azure Stack.

  4. Immettere una descrizione per l'app.

  5. Copiare l'URL di callback. In una distribuzione predefinita dell'hub di Azure Stack, l'URL di callback è nel formato https://portal.<region>.<FQDN>/TokenAuthorize. Affinché l'integrazione di BitBucket abbia esito positivo, l'URL deve seguire le maiuscole elencate qui.

  6. Immettere l'URL. Questo URL deve essere l'URL del portale dell'hub di Azure Stack. Ad esempio: https://portal.<region>.<FQDN>.

  7. Selezionare le autorizzazioni necessarie:

    • Repository: Leggere
    • Webhook: lettura e scrittura

  8. Seleziona Salva. Questa nuova app viene ora visualizzata, insieme alla chiave e al segreto, in OAuth consumers.

    Elenco applicazioni BitBucket

  9. In una nuova scheda o finestra del browser accedere al portale di amministrazione dell'hub di Azure Stack come amministratore del servizio.

  10. Passare a Provider di Risorse e selezionare l'Amministratore del Provider di Risorse del Servizio App.

  11. Selezionare Configurazione del controllo sorgente.

  12. Copia e incolla la chiave nella casella di input ID client e il segret nella casella di input Segreto client per BitBucket.

  13. Seleziona Salva.

Configurare OneDrive

Per completare questa attività, è necessario disporre di un account Microsoft collegato a un account OneDrive. È possibile usare un account per l'organizzazione anziché un account personale.

Nota

Gli account OneDrive for Business non sono attualmente supportati.

  1. Passare a https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade e accedere usando l'account Microsoft.

  2. In Registrazioni app selezionare Nuova registrazione.

  3. Immettere un nome per la registrazione della nuova app, ad esempio immettere servizio app nell'hub di Azure Stack.

  4. In Tipi di account supportati selezionare Solo account Microsoft personali.

  5. Immettere l'URI di reindirizzamento. Scegliere piattaforma - Web e in una distribuzione predefinita dell'hub di Azure Stack, l'URI di reindirizzamento è nel formato : https://portal.<region>.<FQDN>/TokenAuthorize.

  6. Selezionare Registra.

  7. Nella schermata successiva sono elencate le proprietà della nuova app. Salvare l'ID applicazione (client) in una posizione temporanea.

  8. In Certificati e segreti scegliere Segreti client e selezionare Nuovo segreto client. Specificare una descrizione e scegliere la lunghezza di scadenza per il nuovo segreto e selezionare Aggiungi.

  9. Prendere nota del valore del nuovo segreto.

  10. In Autorizzazioni API selezionare Aggiungi un'autorizzazione.

  11. Aggiungere le autorizzazioni delegate di - Microsoft Graph.

    • Files.ReadWrite.AppFolder
    • Utente. Leggi

  12. In una nuova scheda o finestra del browser accedere al portale di amministrazione dell'hub di Azure Stack come amministratore del servizio.

  13. Passare a Provider di risorse e selezionare l'Amministratore del provider di risorse del servizio app.

  14. Selezionare Configurazione del controllo del codice sorgente.

  15. Copia e incolla l'ID Applicazione (client) nella casella di immissione ID client e il Codice segreto nella casella di immissione Segreto client per OneDrive.

  16. Seleziona Salva.

Configurare Dropbox

Nota

Per completare questa attività, è necessario disporre di un account DropBox. È possibile usare un account per l'organizzazione anziché un account personale.

  1. Passare a https://www.dropbox.com/developers/apps e accedere usando le credenziali dell'account DropBox.

  2. Selezionare Crea app.

    App Dropbox

  3. Selezionare DropBox API.

  4. Impostare il livello di accesso su Cartella App.

  5. Immettere un nome per l'app.

    Registrazione applicazione Dropbox

  6. Seleziona Crea app. Viene visualizzata una pagina che elenca le impostazioni per l'app, tra cui chiave dell'app e segreto dell'app.

  7. Assicurarsi che il nome della cartella dell'app sia impostato su servizio app nell'hub di Azure Stack.

  8. Impostare l'URI di reindirizzamento OAuth 2 e quindi selezionare Aggiungi. In una distribuzione predefinita dell'hub di Azure Stack, l'URI di reindirizzamento è nel formato https://portal.<region>.<FQDN>/TokenAuthorize.

    Configurazione dell'applicazione Dropbox

  9. In una nuova scheda o finestra del browser accedere al portale di amministrazione dell'hub di Azure Stack come amministratore del servizio.

  10. Passare a Provider di risorse e selezionare l'Amministratore del provider di risorse del servizio app.

  11. Selezionare Configurazione del controllo del codice sorgente.

  12. Copia e incolla la Chiave Applicazione nella casella di input ID client e il Segreto app nella casella di input Segreto client per DropBox.

  13. Seleziona Salva.

Importante

Se si riconfigurano le applicazioni esistenti dopo l'aggiornamento al servizio app Azure nell'hub di Azure Stack 2022 H1, è necessario revocare tutti i token e gli utenti finali dovranno riautorizzare con i provider nelle applicazioni per abilitare la sincronizzazione dai provider di controllo del codice sorgente

Configurare GitHub

Per completare questa attività, è necessario disporre di un account GitHub. È possibile usare un account per l'organizzazione anziché un account personale.

  1. Accedere a GitHub, passare a https://www.github.com/settings/developerse quindi selezionare Registra una nuova applicazione.

    GitHub - Registrare una nuova applicazione

  2. Inserisci un Nome applicazione. Ad esempio, servizio app nell'hub di Azure Stack.

  3. Immettere l'URL della homepage. L'URL della home page deve essere l'indirizzo del portale dell'hub di Azure Stack. Ad esempio: https://portal.<region>.<FQDN>. Per altre informazioni sul nome di dominio completo (FQDN) dell'hub di Azure Stack, vedere Spazio dei nomi DNS dell'hub di Azure Stack.

  4. Immettere una descrizione dell'applicazione.

  5. Inserisci l'URL di callback dell'autorizzazione. In una distribuzione predefinita dell'hub di Azure Stack, l'URL è nel formato https://api.appservice.<region>.<FQDN>:44300/auth/github/callback.

  6. Selezionare Registra applicazione. Viene visualizzata una pagina che elenca il ID client e il segreto client per l'app.

    GitHub - Registrazione applicazione completata

  7. In una nuova scheda o finestra del browser accedere al portale di amministrazione dell'hub di Azure Stack come amministratore del servizio.

  8. Passare a Provider di risorse e selezionare l'Amministratore del provider di risorse di App Service.

  9. Selezionare Configurazione del controllo del codice sorgente.

  10. Copia e incolla l'ID client e il segreto client nelle caselle di input corrispondenti per GitHub.

  11. Seleziona Salva.

Configurare BitBucket

Per completare questa attività, è necessario disporre di un account BitBucket. È possibile usare un account per l'organizzazione anziché un account personale.

  1. Accedi a BitBucket e vai a Integrazioni nel tuo account.

    Dashboard di BitBucket - Integrazioni

  2. Selezionare OAuth in Gestione degli accessi e Aggiungi consumer.

    BitBucket Aggiungi

  3. Immettere un nome per il consumatore. Ad esempio, servizio app nell'hub di Azure Stack.

  4. Immettere una descrizione per l'app.

  5. Copiare l'URL di callback. In una distribuzione predefinita dell'hub di Azure Stack, l'URL di callback è nel formato https://api.appservice.<region>.<FQDN>:44300/auth/bitbucket/callback. Affinché l'integrazione di BitBucket abbia esito positivo, l'URL deve seguire le maiuscole elencate qui.

  6. Immettere l'URL. Questo URL deve essere l'URL del portale dell'hub di Azure Stack. Ad esempio: https://portal.<region>.<FQDN>.

  7. Selezionare le autorizzazioni necessarie:

    • Repository: Lettura
    • Webhook: lettura e scrittura

  8. Seleziona Salva. Questa nuova app viene ora visualizzata, insieme alla chiave e al segreto, in Consumer OAuth.

    Elenco applicazioni BitBucket

  9. In una nuova scheda o finestra del browser accedere al portale di amministrazione dell'hub di Azure Stack come amministratore del servizio.

  10. Passare a Provider di risorse e selezionare Amministratore del Provider di risorse di Servizi App.

  11. Selezionare Configurazione del controllo del codice sorgente.

  12. Copia e incolla la chiave nella casella di input ID client e il segreto nella casella di input Segreto client per BitBucket.

  13. Seleziona Salva.

Configurare OneDrive

Per completare questa attività, è necessario disporre di un account Microsoft collegato a un account OneDrive. È possibile usare un account per l'organizzazione anziché un account personale.

Nota

Gli account OneDrive for Business non sono attualmente supportati.

  1. Passare a https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade e accedere usando l'account Microsoft.

  2. In Registrazioni app selezionare Nuova registrazione.

  3. Immettere un nome per la registrazione della nuova app, ad esempio immettere servizio app nell'hub di Azure Stack.

  4. In Tipi di account supportati selezionare Solo account Microsoft personali

  5. Immettere l'URI di reindirizzamento. Scegliere piattaforma - Web e in una distribuzione predefinita dell'hub di Azure Stack, l'URI di reindirizzamento è nel formato : https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callback.

  6. Selezionare Registra

  7. Nella schermata successiva sono elencate le proprietà della nuova app. Salvare l'ID applicazione (client) in una posizione temporanea.

  8. In Certificati e segreti scegliere Segreti client e selezionare Nuovo segreto client. Specificare una descrizione e scegliere la lunghezza di scadenza per il nuovo segreto e selezionare Aggiungi.

  9. Prendere nota del valore del nuovo segreto.

  10. In Autorizzazioni API selezionare Aggiungi un'autorizzazione

  11. Aggiungere le autorizzazioni delegate di - Microsoft Graph.

    • Files.ReadWrite.AppFolder
    • Utente. Leggi

  12. In una nuova scheda o finestra del browser accedere al portale di amministrazione dell'hub di Azure Stack come amministratore del servizio.

  13. Passare a Provider di risorse e selezionare l'Amministratore del Provider di Risorse Servizio App.

  14. Selezionare Configurazione del controllo del codice sorgente.

  15. Copia e incolla l'ID applicazione (client) nel campo di inserimento ID client e il Segreto nel campo di inserimento Segreto client per OneDrive.

  16. Seleziona Salva.

Configurare Dropbox

Nota

Per completare questa attività, è necessario disporre di un account DropBox. È possibile usare un account per l'organizzazione anziché un account personale.

  1. Passare a https://www.dropbox.com/developers/apps e accedere usando le credenziali dell'account DropBox.

  2. Selezionare Crea app.

    App Dropbox

  3. Selezionare DropBox API.

  4. Impostare il livello di accesso su Cartella App.

  5. Immettere un nome per l'app.

    Registrazione applicazione Dropbox

  6. Seleziona Crea app. Viene visualizzata una pagina che elenca le impostazioni per l'app, tra cui chiave dell'app e segreto dell'app.

  7. Assicurarsi che il nome della cartella dell'app sia impostato su servizio app nell'hub di Azure Stack.

  8. Impostare l'URI di reindirizzamento OAuth 2 e quindi selezionare Aggiungi. In una distribuzione predefinita dell'hub di Azure Stack, l'URI di reindirizzamento è nel formato https://api.appservice.<region>.<FQDN>:44300/auth/dropbox/callback.

    Configurazione dell'applicazione Dropbox

  9. In una nuova scheda o finestra del browser accedere al portale di amministrazione dell'hub di Azure Stack come amministratore del servizio.

  10. Passare a Provider di risorse e selezionare l'Amministratore del provider di risorse del servizio App.

  11. Selezionare configurazione del controllo sorgente.

  12. Copiare e incollare la chiave applicazione nella casella di input ID client e il segretapplicazione nella casella di input Segreto client per DropBox.

  13. Seleziona Salva.

Passaggi successivi

Gli utenti possono ora usare le origini di distribuzione per operazioni come la distribuzione continua, la distribuzione Git locale e la sincronizzazione delle cartelle cloud.