Creare attività per le personalizzazioni del team di Dev Box
Quando si creano attività per le personalizzazioni del team di Microsoft Dev Box, è possibile definire azioni specifiche per le finestre di sviluppo per garantire un ambiente di sviluppo coerente ed efficiente. La creazione di nuove attività in un catalogo consente di definire componenti riutilizzabili personalizzati per i team di sviluppo e aggiungere protezioni per le configurazioni possibili. Questo articolo illustra la creazione di un catalogo per le attività di personalizzazione, l'aggiunta di attività e il collegamento del catalogo a un dev center o progetto.
Importante
La funzionalità di personalizzazione del team di Dev Box è attualmente in anteprima. Per altre informazioni sulle anteprime, vedere Condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure. Il documento definisce i termini legali applicabili alle funzionalità di Azure in versione beta, in anteprima o non ancora rilasciate nella disponibilità generale.
Prerequisiti
Per seguire la procedura descritta in questo articolo, è necessario avere:
- Dev Center configurato con un progetto dev box.
- Un catalogo esistente in GitHub o Azure Repos.
Autorizzazioni necessarie per configurare le personalizzazioni
Per eseguire le azioni necessarie per la creazione e l'applicazione di personalizzazioni a una finestra di sviluppo, sono necessarie le autorizzazioni seguenti:
| Azione | Autorizzazione/ruolo |
|---|---|
| Abilitare cataloghi a livello di progetto per un dev center. | Tecnico della piattaforma con accesso in scrittura alla sottoscrizione. |
| Abilitare le impostazioni di sincronizzazione del catalogo per un progetto. | Tecnico della piattaforma con accesso in scrittura alla sottoscrizione. |
| Allegare un catalogo a un progetto. | Autorizzazioni di amministratore del progetto o collaboratore per il progetto. |
| Creare un file di personalizzazione. | Nessuno specificato. Chiunque può creare un file di personalizzazione. |
| Usare il portale per sviluppatori per caricare e applicare un file YAML durante la creazione della casella di sviluppo. | Utente di Dev Box. |
| Aggiungere attività a un catalogo. | Autorizzazione per aggiungere al repository che ospita il catalogo. |
Che cosa sono le attività?
Un'attività esegue un'azione specifica, come ad esempio l'installazione del software. Ogni attività è costituita da uno o più script di PowerShell, insieme a un file task.yaml che fornisce parametri e definisce la modalità di esecuzione degli script. È anche possibile includere un comando di PowerShell nel file task.yaml.
È possibile archiviare una raccolta di attività curate in un catalogo collegato al dev center, con ogni attività in una cartella separata. Dev Box supporta l'uso di un repository GitHub o di un repository Azure Repos come catalogo. Dev Box analizza in modo ricorsivo una cartella specificata del catalogo per trovare le definizioni delle attività.
WinGet e PowerShell sono disponibili in qualsiasi dev center senza richiedere un catalogo. Se le personalizzazioni usano solo WinGet o PowerShell, è possibile creare attività che le usano in un file di personalizzazione. Se è necessario usare altri strumenti o script, è possibile creare attività in un catalogo.
Microsoft offre un catalogo di avvio rapido per iniziare a usare le personalizzazioni. Include un set predefinito di attività che definiscono azioni comuni:
- Installare il software usando gestione pacchetti WinGet.
- Distribuire DSC (Desired State Configuration) usando la configurazione WinGet.
- Clonare un repository usando
git-clone. - Configurare applicazioni come l'installazione delle estensioni di Visual Studio.
- Eseguire script di PowerShell.
Creare attività in un catalogo
Le attività, ad esempio l'installazione di software o script in esecuzione, sono organizzate in un catalogo. Si creano e si gestiscono attività in un catalogo, si definiscono nuove attività e si collega il catalogo a un dev center. Con il catalogo di avvio rapido di Microsoft è possibile iniziare a usare attività comuni, ad esempio l'installazione di software, la distribuzione di DSC, la clonazione di repository e la configurazione delle applicazioni.
Definire nuove attività
Per creare e gestire le attività per le personalizzazioni del team di Dev Box, seguire questa procedura:
Creare un repository per archiviare le attività. Facoltativamente, è possibile creare una copia del catalogo di avvio rapido nel proprio repository da usare come punto di partenza.
Creare attività nel repository modificando gli script di PowerShell esistenti o creando nuovi script. Per iniziare a creare attività, è possibile usare gli esempi nel repository GitHub per esempi di Dev Center e nella documentazione di PowerShell.
Collegare il repository al centro di sviluppo come catalogo.
Creare un file di configurazione per tali attività seguendo la procedura descritta in Scrivere un file di personalizzazione.
Usare i segreti da un insieme di credenziali delle chiavi di Azure
È possibile usare i segreti dell'insieme di credenziali delle chiavi di Azure nelle configurazioni YAML per clonare repository privati o con qualsiasi attività personalizzata creata che richiede un token di accesso.
Il dev center deve accedere all'insieme di credenziali delle chiavi. DevCenter non supporta i tag del servizio, quindi se l'insieme di credenziali delle chiavi viene mantenuto privato, è necessario consentire ai servizi Microsoft attendibili di ignorare il firewall.
Per configurare i segreti dell'insieme di credenziali delle chiavi da usare nelle configurazioni YAML:
Assicurarsi che l'identità gestita del progetto dev center abbia il ruolo Lettore dell'insieme di credenziali delle chiavi e il ruolo utente Dei segreti dell'insieme di credenziali delle chiavi nell'insieme di credenziali delle chiavi.
Concedere il ruolo utente dei segreti dell'insieme di credenziali delle chiavi per il segreto dell'insieme di credenziali delle chiavi a ogni utente o gruppo di utenti in grado di utilizzare il segreto durante la personalizzazione di una casella di sviluppo. L'utente o il gruppo a cui viene concesso il ruolo deve includere l'identità gestita per il dev center, il proprio account utente e qualsiasi utente o gruppo che necessita del segreto durante la personalizzazione di una casella di sviluppo.
Per altre informazioni sull'uso dei segreti dell'insieme di credenziali delle chiavi in un file di personalizzazione, vedere Clonare un repository privato usando un file di personalizzazione.
Allegare un catalogo
È possibile allegare un catalogo a un progetto per rendere accessibili le attività al team di sviluppo. Per collegare un catalogo a un progetto, seguire la procedura descritta in Aggiungere e configurare un catalogo da GitHub o Azure Repos.