Esercizio: Configurare l'ambiente Azure DevOps

• 8 minuti

In questa unità ci si assicurerà che la propria organizzazione Microsoft Azure DevOps sia pronta per completare il resto del modulo.

A tale scopo, eseguire l'operazione seguente:

Ottenere il progetto Azure DevOps

In questa sezione ci si assicurerà che l'organizzazione Azure DevOps sia configurata per completare il resto del modulo. A questo scopo, eseguire un modello per la creazione di un progetto in Azure DevOps.

Eseguire il modello

Eseguire un modello che configura automaticamente tutti gli aspetti dell'organizzazione Azure DevOps.

Nel sito Demo Generator di Azure DevOps seguire questa procedura per eseguire il modello:

1. Selezionare Accedi e accettare le condizioni d’uso.

2. Nella pagina Crea nuovo progetto selezionare l'organizzazione di Azure DevOps e immettere un nome di progetto, ad esempio Space Game - Web - Tests.

3. Selezionare la casella accando a Sì, voglio creare una copia tramite fork del repository e quindi selezionare Autorizza. Se viene visualizzata una finestra, autorizzare l'accesso all'account GitHub.

   Importante

   È necessario selezionare questa opzione per connettere il modello al repository GitHub. Selezionare questa opzione anche se è già stata creata una copia tramite fork del progetto del sito Web di Space Game. Il modello usa il fork esistente.

4. Selezionare Crea progetto.

   

   L'esecuzione del modello richiede qualche secondo.

5. Selezionare Passa al progetto per passare al progetto in Azure DevOps.

Impostare la visibilità del progetto

Inizialmente, la copia tramite fork del repository Space Game in GitHub è impostata su pubblica mentre il progetto creato dal modello Azure DevOps è impostato su privato. Un repository pubblico in GitHub può essere accessibile da chiunque, mentre un repository privato è accessibile solo all'utente e alle persone con cui si sceglie di condividerlo. Analogamente, in Azure DevOps, i progetti pubblici forniscono l'accesso in sola lettura agli utenti non autenticati, mentre i progetti privati richiedono l'accesso e l'autenticazione degli utenti per accedere ai servizi.

Al momento, non è necessario modificare alcuna di queste impostazioni ai fini di questo modulo. Tuttavia, per i progetti personali, è necessario determinare la visibilità e l'accesso che si desidera concedere ad altri utenti. Ad esempio, se il progetto è open source, è possibile rendere pubblici il repository GitHub e il progetto Azure DevOps. Se il progetto è closed source, probabilmente si preferirà che il repository GitHub e il progetto DevOps di Azure siano privati.

Più avanti, è possibile trovare le risorse seguenti utili per determinare quale opzione è migliore per il progetto:

• Usare progetti privati e pubblici
• Avvio rapido: rendere pubblico il progetto privato
• Setting repository visibility (Impostazione della visibilità del repository)

Configurare il progetto in locale

In questa sezione si caricherà il progetto di Space Game in Visual Studio Code, si configurerà Git, si clonerà il repository in locale e si imposterà il repository remoto upstream in modo che sia possibile scaricare il codice di avvio.

Aprire il terminale integrato

Visual Studio Code è dotato di un terminale integrato per poter modificare i file e lavorare dalla riga di comando in un'unica posizione.

1. Avviare Visual Studio Code.

2. Nel menu Visualizza selezionare Terminale.

3. Nell'elenco a discesa selezionare bash. Se si preferisce usare un'altra shell Unix con cui si ha più familiarità, ad esempio Zsh, selezionare la shell desiderata.

   

   Nella finestra del terminale è possibile scegliere qualsiasi shell installata nel sistema, ad esempio Bash, Zsh e PowerShell.

   In questa procedura si userà Bash. Git per Windows offre Git Bash, che semplifica l'esecuzione di comandi Git.

   Nota

   In Windows, se Git Bash non è elencato come opzione, assicurarsi di aver installato Git e quindi riavviare Visual Studio Code.

4. Eseguire il comando cd per passare alla directory in cui si vuole lavorare, ad esempio la home directory (~). In alternativa, è possibile scegliere una directory diversa.

   cd ~
   

Configurazione di Git

Se non si ha familiarità con Git e GitHub, è prima di tutto necessario eseguire alcuni comandi per associare l'identità a Git ed eseguire l'autenticazione con GitHub.

Il documento Configurare Git illustra il processo in modo più dettagliato.

È necessario completare almeno i passaggi seguenti. Eseguire i comandi seguenti dal terminale integrato:

1. Impostare il nome utente.
2. Impostare l'indirizzo di posta elettronica di commit.
3. Memorizzare nella cache la password di GitHub.

Configurare il progetto in Visual Studio Code

In questo modulo si eseguirà la clonazione del fork in locale, in modo da poter modificare e compilare la configurazione della pipeline.

Clonare il fork in locale

È ora disponibile una copia del progetto Web di Space Game nell'account GitHub. A questo punto, è possibile scaricare o clonare una copia nel computer per poterla usare.

Un clone, analogamente a un fork, è una copia di un repository. Quando si clona un repository, è possibile apportare modifiche, verificare che funzionino come previsto e quindi caricare tali modifiche in GitHub. È anche possibile sincronizzare la copia locale con le modifiche apportate da altri utenti autenticati alla copia di GitHub del repository.

Per clonare il progetto Web di Space Game nel computer:

1. Passare al fork del progetto Web di Space Game (mslearn-tailspin-spacegame-web) in GitHub.

2. Selezionare Codice. Dalla scheda HTTPS scegliere quindi il pulsante accanto all'URL visualizzato per copiare l'URL negli Appunti.

   

3. In Visual Studio Code passare alla finestra del terminale.

4. Nel terminale passare alla directory in cui si vuole lavorare, ad esempio la home directory (~). In alternativa, è possibile scegliere una directory diversa.

   cd ~
   

5. Eseguire il comando git clone. Sostituire l'URL visualizzato in questa sezione con il contenuto degli Appunti:

   git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git
   

6. Passare alla directory mslearn-tailspin-spacegame-web. Si tratta della directory radice del repository.

   cd mslearn-tailspin-spacegame-web
   

Impostare il repository remoto upstream

Un repository remoto è un repository Git in cui i membri del team collaborano (come un repository in GitHub). Qui sono elencati i repository remoti ed è possibile aggiungerne uno che punta alla copia Microsoft del repository in modo che sia possibile ottenere il codice di esempio più recente.

1. Eseguire il comando git remote per elencare i repository remoti:

   git remote -v
   

   Si noterà che sono disponibili sia l'accesso di recupero (download) che l'accesso push (caricamento) al repository:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
   

   Origin specifica il repository in GitHub. Quando si crea una copia tramite fork del codice da un altro repository, il repository remoto originale (quello da cui è stata eseguita la copia tramite fork) viene spesso denominato upstream.

2. Eseguire il comando git remote add per creare un repository remoto denominato upstream che punta al repository Microsoft:

   git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git
   

3. Eseguire git remote una seconda volta per visualizzare le modifiche:

   git remote -v
   

   Si noterà che sono ancora disponibili sia l'accesso di tipo fetch (download) sia quello di tipo push (upload) al repository. Sarà disponibile anche l'accesso di recupero e push al repository Microsoft:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
   upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (fetch)
   upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (push)
   

Aprire il progetto in Esplora file

In Visual Studio Code la finestra del terminale punta alla directory radice del progetto Web di Space Game. Ora si aprirà il progetto da Esplora file per poterne visualizzare la struttura e usare i file.

1. Il modo più semplice per aprire il progetto è riaprire Visual Studio Code nella directory corrente. A questo scopo, eseguire il comando seguente nel terminale integrato:

   code -r .
   

   In Esplora file vengono visualizzati la directory e l'albero dei file.

2. Riaprire il terminale integrato. Il terminale posiziona l'utente alla radice del progetto Web.

Se il comando code non riesce, è necessario aggiungere Visual Studio Code al percorso di sistema. A questo scopo:

1. In Visual Studio Code selezionare F1 o Visualizza>Riquadro comandi per accedere al riquadro comandi.
2. Nel riquadro comandi immettere Comando della shell: Installa il comando 'code' in PATH.
3. Ripetere la procedura precedente per aprire il progetto in Esplora file.

A questo punto, è possibile usare il codice sorgente di Space Game e la configurazione di Azure Pipelines dall'ambiente di sviluppo locale.