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

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 nel provider di controllo del codice sorgente.

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

  • GitHub
  • BitBucket
  • OneDrive
  • DropBox

Visualizzare le origini di distribuzione nell'amministrazione di servizio app

  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 servizio app

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

    servizio app configurazione del controllo del codice sorgente amministratore del provider di risorse

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 in Nome applicazione. Ad esempio, servizio app nell'hub di Azure Stack.

  3. Immettere l'URL della home page. 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 il valore relativo all'URL di callback 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 client e il segreto client per l'app.

    GitHub - Registrazione dell'applicazione completata

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

  8. Passare a Provider di risorse e selezionare il servizio app provider di risorse Amministrazione.

  9. Selezionare Configurazione del controllo del codice sorgente.

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

  11. Selezionare 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. Accedere a BitBucket e passare a Integrations sotto l'account.

    Dashboard BitBucket - Integrazioni

  2. Selezionare OAuth in Gestione accessi e Aggiungi consumer.

    BitBucket Aggiungi consumer OAuth

  3. Immettere un nome per il consumer. 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. Per consentire l'integrazione di BitBucket, l'URL deve seguire la maiuscola elencata 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. Selezionare Salva. Questa nuova app viene ora visualizzata, insieme alla chiave e al segreto, in Consumer OAuth.

    Elenco di applicazioni BitBucket

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

  10. Passare a Provider di risorse e selezionare il servizio app provider di risorse Amministrazione.

  11. Selezionare Configurazione del controllo del codice sorgente.

  12. Copiare e incollare la chiave nella casella di input ID client e segreto nella casella di input Segreto client per BitBucket.

  13. Selezionare 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 nuova registrazione dell'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. La schermata successiva elenca le proprietà della nuova app. Salvare l'ID applicazione (client) in una posizione temporanea.

  8. In Certificati & 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. Lettura
  12. In una nuova scheda o finestra del browser accedere al portale di amministratore dell'hub di Azure Stack come amministratore del servizio.

  13. Passare a Provider di risorse e selezionare il servizio app provider di risorse Amministrazione.

  14. Selezionare Configurazione del controllo del codice sorgente.

  15. Copiare e incollare l'ID applicazione (client) nella casella di input ID client e segreto nella casella di input Segreto client per OneDrive.

  16. Selezionare 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 Api DropBox.

  4. Impostare il livello di accesso su Cartella app.

  5. Immettere un nome per l'app.

    Registrazione dell'applicazione Dropbox

  6. Selezionare Crea app. Viene visualizzata una pagina che elenca le impostazioni per l'app, inclusa la chiave app e il segreto dell'app.

  7. Assicurarsi che il nome della cartella 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 amministratore dell'hub di Azure Stack come amministratore del servizio.

  10. Passare a Provider di risorse e selezionare il servizio app provider di risorse Amministrazione.

  11. Selezionare Configurazione del controllo del codice sorgente.

  12. Copiare e incollare la chiave applicazione nella casella di input ID client e nel segreto dell'app nella casella di input segreto client per DropBox.

  13. Selezionare Salva.

Importante

Se si riconfigurano applicazioni esistenti dopo l'aggiornamento a Servizio app di Azure nell'hub di Azure Stack 2022 H1, è necessario revocare tutti i token e gli utenti finali dovranno riutentare 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. Immettere un nome in Nome applicazione. Ad esempio, servizio app nell'hub di Azure Stack.

  3. Immettere l'URL della home page. 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 il valore relativo all'URL di callback 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 l'ID client e il segreto client per l'app.

    GitHub - Registrazione dell'applicazione completata

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

  8. Passare a Provider di risorse e selezionare il servizio app provider di risorse Amministrazione.

  9. Selezionare Configurazione del controllo del codice sorgente.

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

  11. Selezionare 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. Accedere a BitBucket e passare a Integrations sotto l'account.

    Dashboard BitBucket - Integrazioni

  2. Selezionare OAuth in Gestione accessi e Aggiungi consumer.

    BitBucket Aggiungi consumer OAuth

  3. Immettere un nome per il consumer. 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. Per consentire l'integrazione di BitBucket, l'URL deve seguire la maiuscola elencata 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. Selezionare Salva. Questa nuova app viene ora visualizzata, insieme alla chiave e al segreto, in Consumer OAuth.

    Elenco di applicazioni BitBucket

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

  10. Passare a Provider di risorse e selezionare il servizio app provider di risorse Amministrazione.

  11. Selezionare Configurazione del controllo del codice sorgente.

  12. Copiare e incollare la chiave nella casella di input ID client e segreto nella casella di input Segreto client per BitBucket.

  13. Selezionare 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 nuova registrazione dell'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. La schermata successiva elenca le proprietà della nuova app. Salvare l'ID applicazione (client) in una posizione temporanea.

  8. In Certificati & 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. Lettura
  12. In una nuova scheda o finestra del browser accedere al portale di amministratore dell'hub di Azure Stack come amministratore del servizio.

  13. Passare a Provider di risorse e selezionare il servizio app provider di risorse Amministrazione.

  14. Selezionare Configurazione del controllo del codice sorgente.

  15. Copiare e incollare l'ID applicazione (client) nella casella di input ID client e segreto nella casella di input Segreto client per OneDrive.

  16. Selezionare 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 (API DropBox).

  4. Impostare il livello di accesso su Cartella app.

  5. Immettere un nome per l'app.

    Registrazione dell'applicazione Dropbox

  6. Selezionare Crea app. Viene visualizzata una pagina che elenca le impostazioni per l'app, inclusa la chiave dell'app e il 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 servizio app provider di risorse Amministrazione.

  11. Selezionare Configurazione del controllo del codice sorgente.

  12. Copiare e incollare la chiave dell'applicazione nella casella di input ID client e nel segreto dell'app nella casella di input Segreto client per DropBox.

  13. Selezionare 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.