Guida introduttiva: Creare una macchina di sviluppo utilizzando le personalizzazioni del team

In questa guida introduttiva si crea una casella di sviluppo usando le personalizzazioni del team di Microsoft Dev Box. La funzionalità usa un file di definizione dell'immagine in modo che sia possibile creare box di sviluppo personalizzati in modo coerente per il team di sviluppo e fornire un ambiente personalizzato per i progetti.

Prerequisiti

Prodotto	Requisiti
Microsoft Dev Box	- Configurare un dev center con un pool di box di sviluppo e un progetto di dev box in modo da poter creare una casella di sviluppo. - Collegare un catalogo al dev center con le attività che è possibile usare nel file di definizione dell'immagine. Se non si ha un catalogo, vedere Aggiungere e configurare un catalogo da GitHub o Azure Repos. -Autorizzazioni - Per creare una casella di sviluppo: Partecipare al gruppo di sicurezza Dev Box Users per almeno un progetto. - Per abilitare cataloghi a livello di progetto per un dev center: Tecnico della piattaforma con accesso in scrittura alla sottoscrizione. - Per abilitare le impostazioni di sincronizzazione del catalogo per un progetto: Tecnico della piattaforma con accesso in scrittura alla sottoscrizione. - Per collegare un catalogo a un progetto: Autorizzazioni di amministratore del progetto o collaboratore di Dev Center per il progetto. - Per creare un file di personalizzazione: Nessuno specificato. Chiunque può creare un file di personalizzazione. - Per usare il portale per sviluppatori per caricare e applicare un file YAML durante la creazione della casella di sviluppo: Utente di Dev Box. - Per aggiungere attività a un catalogo: Autorizzazione per aggiungere al repository che ospita il catalogo.
Visual Studio Code	- Installare la versione più recente

Creare una definizione dell'immagine

Per creare una finestra di sviluppo con personalizzazioni, è necessario creare un file di definizione dell'immagine. Il file di definizione dell'immagine è un file YAML che contiene le personalizzazioni da applicare alla casella di sviluppo. È possibile usare il file di definizione dell'immagine di esempio in questa guida introduttiva come punto di partenza.

Abilitare cataloghi a livello di progetto

Per poter aggiungere un catalogo a un progetto, è necessario prima abilitare i cataloghi a livello di progetto a livello di dev center.

1. Nel portale di Azure passare al dev center.

2. Nel menu del servizio, in Impostazioni, selezionare Impostazioni di Dev Center.

3. In Cataloghi a livello di progetto selezionare Abilita cataloghi per progetto e quindi selezionare Applica.

   

Aggiungere un catalogo al progetto

Le sezioni seguenti illustrano queste attività:

1. Creare una copia tramite fork del repository del catalogo di esempio nell’organizzazione GitHub.
2. Configurare le impostazioni di sincronizzazione per sincronizzare il catalogo con il progetto.
3. Aggiungere il repository come catalogo.

Creare una copia tramite fork del repository del catalogo di esempio

1. Aprire il repository del catalogo di esempio.

2. Selezionare ForkCrea un nuovo fork per creare una copia tramite fork> del repository nell'organizzazione GitHub.

   

Configurare le impostazioni di sincronizzazione del catalogo

1. Tornare al portale di Azure.

2. Nella casella di ricerca immettere progetti. Nell'elenco dei risultati selezionare Progetti.

3. Selezionare il progetto a cui si vuole aggiungere il catalogo.

4. Nel menu a sinistra selezionare Impostazioni>Cataloghi.

5. Selezionare Sincronizza impostazioni.

   

6. Nel riquadro Impostazioni di sincronizzazione :

   • Se le definizioni di immagine sono deselezionate, selezionarla e selezionare Salva.
   • Se le definizioni di immagine sono già selezionate, selezionare Annulla.

   

Aggiungere il repository come catalogo

1. Nella pagina Cataloghi selezionare Aggiungi.

2. Nel riquadro Aggiungi catalogo, immettere o selezionare i valori seguenti:

   Campo	valore
   Nome	Immettere un nome per il catalogo.
   Origine catalogo	Selezionare GitHub.
   Tipo di autenticazione	Selezionare App GitHub.

3. Selezionare il collegamento Configura i repository.

   

4. Se viene richiesto di eseguire l'autenticazione in GitHub, eseguire tale operazione.

5. Nella pagina Microsoft DevCenter selezionare Configura.

   

6. Selezionare l'organizzazione GitHub che contiene il repository da aggiungere come catalogo. Per installare l'app, è necessario essere un proprietario dell'organizzazione.

   

7. Nella pagina Installa Microsoft DevCenter selezionare Solo repository, selezionare il repository da aggiungere come catalogo e quindi selezionare Salva.

   

   È possibile selezionare più repository da aggiungere come cataloghi. È necessario aggiungere ogni repository come catalogo separato, come descritto nella sezione successiva di questa guida introduttiva.

8. Tornare al portale di Azure.

9. Nel riquadro Aggiungi catalogo selezionare Accedi con GitHub.

10. Nel riquadro Aggiungi catalogo, immettere le informazioni seguenti e quindi selezionare Aggiungi:

    Campo	valore
    Repository	Selezionare il repository che contiene la definizione dell'immagine. Esempio: eShop
    Ramo	Selezionare il ramo . Esempio: main
    Percorso cartella	Selezionare la cartella contenente le sottocartelle che contengono le definizioni delle immagini. Esempio: .devcenter/catalog/image-definitions

11. Nel riquadro Cataloghi verificare che venga visualizzato il catalogo. Quando la connessione ha esito positivo, nella colonna Stato viene visualizzata la sincronizzazione riuscita.

    

12. Verificare che le definizioni delle immagini siano sincronizzate correttamente. Nel menu a sinistra selezionare Gestisci>definizioni di immagine. In questo esempio vengono visualizzate due definizioni di immagine:

    • backend-dev : questa immagine è un'immagine di Microsoft Visual Studio + Tools in Windows 11, adatta per l'ambiente di progettazione back-end eShop.
    • frontend-dev : questa immagine è un'immagine di Microsoft Visual Studio + Tools in Windows 11, adatta per l'ambiente di progettazione front-end eShop.

    

Creare un pool di macchine di sviluppo per la definizione dell'immagine

Per rendere il file di personalizzazione, imagedefintion.yaml, accessibile per la creazione di finestre di sviluppo, è necessario specificarlo come definizione di immagine per un pool.

Per creare un pool di box di sviluppo associato a un progetto:

1. Nel portale di Azure.

2. Nella casella di ricerca immettere progetti. Nell'elenco dei risultati selezionare Progetti.

3. Aprire il progetto in cui si vuole creare il pool di macchine di sviluppo.

4. Nel menu a sinistra selezionare Gestisci pool> dicaselle di sviluppo

5. Nella pagina Pool di caselle di sviluppo selezionare Crea.

6. Nel riquadro Crea un pool di macchine di sviluppo, immettere i valori seguenti:

   Impostazione	valore
   Nome	Immettere un nome descrittivo per il pool. Il nome del pool è visibile agli sviluppatori per selezionare quando creano finestre di sviluppo, quindi includere lo scopo e l'area del pool. Il nome deve essere univoco nel progetto. Esempio: contoso-frontend-westUS
   Definizione	Nella sezione definizione dell'immagine dell'elenco selezionare una definizione di immagine. Esempio: contoso-catalog/frontend-dev
   Calcolo	Selezionare le risorse di calcolo per le caselle di sviluppo nel pool. Esempio: 8 vCPU, 32 GB di RAM
   Spazio di archiviazione	Selezionare le opzioni di archiviazione per le caselle di sviluppo nel pool. Esempio: UNITÀ SSD da 256 GB
   Ibernazione	L'ibernazione è supportata quando l'immagine di origine e le dimensioni di calcolo sono entrambe compatibili con l'ibernazione.
   Connessione di rete	1. Selezionare Distribuisci in una reteospitata da Microsoft. 2. Selezionare un'area di distribuzione per le caselle di sviluppo. Scegliere un'area vicina agli utenti della casella di sviluppo per un'esperienza utente ottimale. Esempio: Stati Uniti occidentali
   Licenze	Selezionare questa casella di controllo per verificare che l'organizzazione disponga di licenze del Vantaggio Azure Hybrid da applicare alle macchine di sviluppo in questo pool.

   

7. Selezionare Crea.

8. Verificare che nell'elenco sia visualizzato il nuovo pool di macchine di sviluppo. Potrebbe essere necessario aggiornare la schermata.

Il portale di Azure distribuisce il pool di macchine di sviluppo ed esegue i controlli di integrità per assicurarsi che l'immagine e la rete superino i criteri di convalida per le macchine di sviluppo.

Creare una macchina di sviluppo dal pool di macchine di sviluppo

Quando si crea una macchina di sviluppo da un pool di macchine di sviluppo, la definizione dell'immagine viene applicata alla macchina di sviluppo. La casella di sviluppo viene creata con le personalizzazioni specificate dal file di definizione dell'immagine.

Per creare una macchina di sviluppo nel portale per sviluppatori Microsoft Dev Box:

1. Accedere al portale per sviluppatori di Microsoft Dev Box.

2. Selezionare Nuovo>Nuova macchina di sviluppo.

3. In Aggiungi una macchina di sviluppo immettere i valori seguenti:

   Impostazione	valore
   Nome	Immettere un nome per la macchina di sviluppo. I nomi delle caselle di sviluppo devono essere univoci all'interno di un progetto. Esempio: contoso-frontend-dev-box
   Progetto	Il portale per sviluppatori elenca i progetti a cui si ha accesso. Selezionare il progetto necessario dall'elenco.
   Pool macchine di sviluppo	Il portale per sviluppatori elenca tutti i pool di caselle di sviluppo per il progetto selezionato. Selezionare il pool appropriato per il lavoro. Scegliere un pool di box di sviluppo vicino all'utente per ottenere la latenza più bassa.
   Applicare personalizzazioni	Lasciare deselezionata questa casella di controllo. Viene usato per applicare personalizzazioni utente. In questo articolo sono state configurate le personalizzazioni del team.

   Dopo aver effettuato le selezioni, la pagina mostra le informazioni seguenti:

   • Se l'ibernazione è supportata o meno.
   • Una notifica che il processo di creazione della macchina di sviluppo può richiedere 25 minuti o più.

4. Selezionare Crea per iniziare a creare la macchina di sviluppo.

5. Per tenere traccia dello stato di avanzamento della creazione, usare il riquadro della casella di sviluppo nel portale per sviluppatori.

Verificare che le personalizzazioni siano applicate

Dev Box applica le personalizzazioni come fase finale del processo di creazione. Dev Box invia un messaggio di posta elettronica quando la casella di sviluppo è pronta. È quindi possibile verificare che vengano applicate le personalizzazioni.

1. Attendere la creazione della casella di sviluppo.

2. Nel riquadro della casella di sviluppo del portale per sviluppatori selezionare Azioni>Personalizzazioni.

   

3. Nel riquadro Dettagli personalizzazione, verificare le personalizzazioni applicate alla casella di sviluppo.

   

Pulire le risorse

1. Accedere al portale per sviluppatori.

2. Per la casella di sviluppo da eliminare, nel menu Azioni, selezionare Elimina.

   

3. Per confermare l'eliminazione, selezionare Elimina.

   

Contenuti correlati

• Personalizzazioni di Microsoft Dev Box
• Scrivere un file di personalizzazione per una casella di sviluppo