Esercizio - Inizializzare un repository Git

5 minuti

Si è deciso che il flusso di lavoro potrebbe trarre vantaggio da un sistema di controllo della versione e si proverà a usare Git. In questo esercizio si predisporranno tutti i requisiti per iniziare a usare Git.

Durante il processo, si eseguiranno queste operazioni:

Installare e configurare Git.
Creare e inizializzare un repository Git.
Aggiungere un file Bicep alla cartella del repository e verificare come cambia lo stato del repository.

Nota

Visual Studio Code è un potente editor che consente di realizzare lo stesso risultato in molti modi diversi. Per quasi ogni azione sono disponibili tasti di scelta rapida. Spesso esistono diversi modi per eseguire azioni comuni usando anche l'interfaccia utente. Questo modulo illustrerà come eseguire le azioni con un unico approccio. Se si vuole, è possibile usare un approccio diverso.

Installare Git

Installare Git. Scegliere la versione corretta in base al sistema operativo.
Se è già stato aperto Visual Studio Code, riavviarlo in modo che rilevi l'installazione di Git.

Configurazione di Git

È necessario eseguire alcuni comandi per configurare Git in modo da associare il proprio nome e l'indirizzo di posta elettronica all'attività. Questa identificazione è utile quando si usa Git per collaborare con altri utenti. Se Git è già stato configurato, è possibile ignorare questi passaggi e procedere alla sezione successiva.

Aprire Visual Studio Code.
Aprire una finestra del terminale di Visual Studio Code selezionando Terminale>Nuovo terminale. La finestra si apre in genere nella parte inferiore della schermata.
Per verificare che GIT sia installato, immettere il comando seguente:
```
git --version
```
Se viene visualizzato un errore, assicurarsi di aver installato Git, riavviare Visual Studio Code e riprovare.
Impostare il proprio nome usando il comando seguente. Sostituire USER_NAME con il nome utente che si vuole usare. Usare il nome e il cognome in modo da essere riconosciuti dai membri del team.
```
git config --global user.name "USER_NAME"
```
Impostare l'indirizzo di posta elettronica usando il comando seguente. Sostituire USER_EMAIL_ADDRESS con il proprio indirizzo di posta elettronica.
```
git config --global user.email "USER_EMAIL_ADDRESS"
```
Eseguire il comando seguente per verificare che le modifiche siano state applicate:
```
git config --list
```
Verificare che l'output includa due righe simili all'esempio seguente. Il nome e l'indirizzo di posta elettronica effettivi saranno diversi da quelli mostrati nell'esempio.
```
user.name=User Name
user.email=user-name@contoso.com
```

Creare e inizializzare un repository Git

Nel terminale di Visual Studio Code creare una nuova cartella denominata toy-website:
```
mkdir toy-website
cd toy-website
```
Usando il terminale di Visual Studio Code, eseguire il comando seguente per riaprire Visual Studio Code con la cartella toy-website caricata:
```
code --reuse-window .
```
Visual Studio Code viene ricaricato. Se viene chiesto se considerare attendibile la cartella, confermare che si considerano attendibili gli autori.
Nel terminale di Visual Studio Code eseguire il comando seguente per inizializzare un nuovo repository Git nella cartella toy-website appena creata:
```
git init
```
Git visualizza un messaggio che conferma l'inizializzazione di un repository Git vuoto.

Aggiungere un file Bicep

Creare una sottocartella denominata deploy. È possibile creare la cartella usando Esplora risorse in Visual Studio Code oppure eseguendo il comando seguente nel terminale di Visual Studio Code:
```
mkdir deploy
```
Nella cartella deploy creare un nuovo file denominato main.bicep.
Salvare il file vuoto in modo che Visual Studio Code carichi gli strumenti di Bicep.

È possibile selezionare File>Salva con nome o premere i tasti di scelta rapida CTRL+S per Windows (⌘+S per macOS). Assicurarsi di ricordare dove è stato salvato il file. Ad esempio, è possibile creare una cartella scripts in cui salvarlo.

Copiare il codice seguente in main.bicep.

@description('The Azure region into which the resources should be deployed.')
param location string = resourceGroup().location

@description('The type of environment. This must be nonprod or prod.')
@allowed([
  'nonprod'
  'prod'
])
param environmentType string

Questo file Bicep contiene due parametri, ma non definisce ancora alcuna risorsa.

Salva il file.

Nota

Anche se il file è stato salvato nella cartella del repository, Git non ne tiene traccia ancora. Si apprenderà in che modo Git tiene traccia dei file nell'unità successiva.

Esaminare lo stato del repository usando l'interfaccia della riga di comando

Git monitora la cartella del repository per rilevare eventuali modifiche. È possibile eseguire una query su Git per visualizzare l'elenco dei file modificati. Questa funzionalità è utile per vedere il lavoro svolto e verificare di non aver aggiunto file per sbaglio o apportato modifiche non previste. Per visualizzare lo stato del repository, è possibile usare sia l'interfaccia della riga di comando di Git che Visual Studio Code.

Usando il terminale di Visual Studio Code, eseguire il comando seguente:
```
git status
```
Esaminare i risultati. Sono simili all'esempio seguente:
```
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        deploy/

nothing added to commit but untracked files present (use "git add" to track)
```
Questo testo contiene quattro informazioni:
- Si è attualmente nel ramo main. I rami verranno illustrato tra poco.
- Non sono stati eseguiti commit in questo repository. I commit verranno illustrati nell'unità successiva.
- Nella cartella deploy sono presenti file non monitorati.
- Non è stato ancora indicato a Git di aggiungere i file di cui il repository deve tenere traccia.
Esaminare la prima riga dell'output del passaggio precedente. Se viene visualizzato un nome di ramo diverso da main, eseguire il comando seguente per rinominare il ramo in main:
```
git branch -M main
```
Questo comando consente di seguire gli esercizi rimanenti di questo modulo.

Esaminare lo stato del repository usando Visual Studio Code

Visual Studio Code mostra le stesse informazioni fornite dal comando git status, ma le integra nell'interfaccia di Visual Studio Code.

In Visual Studio Code selezionare Visualizza>Controllo del codice sorgente o premereCTRL+MAIUSC+G.

Si apre la finestra Controllo del codice sorgente.

Visual Studio Code mostra che il file main.bicep nella cartella deploy è stato modificato. Inoltre, l'icona di Controllo del codice sorgente ha una notifica con il numero 1, che indica che è presente un file non monitorato.
La barra di stato viene visualizzata nella parte inferiore di Visual Studio Code. Fornisce informazioni e funzionalità utili. Verso il lato sinistro della barra di stato viene visualizzata la parola main:

Questa parola indica che si è attualmente nel ramo main. I rami verranno illustrato tra poco.

Lo stato segnalato da Git e Visual Studio Code è lo stesso perché l'interfaccia della riga di comando git e Visual Studio Code usano lo stesso motore Git. È possibile combinare in vari modi gli strumenti da usare per lavorare con i repository. È possibile usare strumenti diversi in base alle esigenze.