Tutorial: crea una pipeline di immagini con l'immagine del contenitore Docker di output dalla procedura guidata della console Image Builder

1. Apri la console EC2 Image Builder all'indirizzo. https://console.aws.amazon.com/imagebuilder/

2. Per iniziare a creare la pipeline, scegli Crea pipeline di immagini.

3. Nella sezione Generale, inserisci il nome della tua pipeline (obbligatorio).

4. Nella sezione Pianificazione della compilazione, puoi mantenere le impostazioni predefinite per le opzioni di pianificazione. Nota che il fuso orario mostrato per la pianificazione predefinita è l'Universal Coordinated Time (UTC). Per ulteriori informazioni sull'ora UTC e per trovare l'offset per il tuo fuso orario, vedi Abbreviazioni dei fusi orari — Elenco mondiale.

   Per le impostazioni di aggiornamento delle dipendenze, scegli l'opzione Esegui pipeline all'ora pianificata se sono presenti aggiornamenti delle dipendenze. Questa impostazione fa sì che la pipeline controlli gli aggiornamenti prima di iniziare la compilazione. Se non ci sono aggiornamenti, salta la creazione pianificata della pipeline.

   Nota

   Per garantire che la pipeline riconosca gli aggiornamenti e le build delle dipendenze come previsto, è necessario utilizzare il controllo semantico delle versioni (x.x.x) per l'immagine di base e i componenti. Per saperne di più sul controllo semantico delle versioni per le risorse di Image Builder, consulta. Versionamento semantico in Image Builder

5. Scegli Avanti per procedere al passaggio successivo.

1. L'impostazione predefinita di Image Builder è Usa la ricetta esistente nella sezione Ricetta. Per la prima volta, scegli l'opzione Crea nuova ricetta.

2. Nella sezione Tipo di immagine, scegli l'opzione Docker image per creare una pipeline di container che produrrà un'immagine Docker e la distribuirà nei repository Amazon ECR nelle regioni di destinazione.

3. Nella sezione Generale, inserisci le seguenti caselle obbligatorie:

   • Nome: il nome della tua ricetta

   • Versione: la versione della tua ricetta (usa il formato <major>. <minor>. <patch>, dove major, minor e patch sono valori interi). Le nuove ricette generalmente iniziano con1.0.0.

4. Nella sezione Source image, mantieni i valori predefiniti per Select image, Image Operating System (OS) e Image origin. Il risultato è un elenco di immagini dei contenitori Amazon Linux 2, gestite da Amazon, tra cui scegliere per l'immagine di base.

   1. Dal menu a discesa Nome immagine, scegli un'immagine.

   2. Mantieni l'impostazione predefinita per Auto-versioning le opzioni (usa l'ultima versione del sistema operativo disponibile).

      Nota

      Questa impostazione garantisce che la pipeline utilizzi il controllo semantico delle versioni per l'immagine di base, per rilevare gli aggiornamenti delle dipendenze per i lavori pianificati automaticamente. Per ulteriori informazioni sul controllo semantico delle versioni per le risorse di Image Builder, vedere. Versionamento semantico in Image Builder

5. Nella sezione Componenti, puoi scegliere di non aggiungere alcun componente e procedere. Se desideri aggiungere componenti, nel pannello Build components — Amazon Linux, puoi sfogliare i componenti elencati nella pagina. Usa il controllo di impaginazione nell'angolo in alto a destra per navigare tra i componenti aggiuntivi disponibili per il tuo sistema operativo con immagine di base. Puoi anche cercare componenti specifici o creare il tuo componente di compilazione utilizzando il Gestore dei componenti.

   Per questo tutorial, scegli un componente che aggiorni Linux con gli ultimi aggiornamenti di sicurezza, come segue:

   1. Filtra i risultati inserendo la parola update nella barra di ricerca che si trova nella parte superiore del pannello.

   2. Seleziona la casella di controllo per il componente di update-linux compilazione.

   3. Scorri verso il basso e, nell'angolo in alto a destra dell'elenco dei componenti selezionati, scegli Espandi tutto.

   4. Mantieni l'impostazione predefinita per le opzioni di controllo delle versioni (usa l'ultima versione disponibile del componente).

      Nota

      Questa impostazione garantisce che la pipeline utilizzi il controllo semantico delle versioni per il componente selezionato, per rilevare gli aggiornamenti delle dipendenze per i lavori pianificati automaticamente. Per ulteriori informazioni sul controllo semantico delle versioni per le risorse di Image Builder, vedere. Versionamento semantico in Image Builder

      Se avessi selezionato un componente con parametri di input, visualizzeresti anche i parametri in quest'area. I parametri non sono trattati in questo tutorial. Per ulteriori informazioni sull'utilizzo dei parametri di input nei componenti e sulla loro impostazione nelle ricette, consultateTutorial: creare un componente personalizzato con parametri di input.

   Riordinare i componenti (opzionale)

   Se hai scelto più di un componente da includere nell'immagine, puoi utilizzare l'azione drag-and-drop per riorganizzarli nell'ordine in cui devono essere eseguiti durante il processo di creazione.

   Nota

   I componenti di rafforzamento CIS non seguono le regole di ordinamento dei componenti standard nelle ricette di Image Builder. I componenti di rafforzamento CIS vengono sempre eseguiti per ultimi per garantire che i test di benchmark vengano eseguiti rispetto all'immagine di output.

   1. Scorri fino all'elenco dei componenti disponibili.

   2. Seleziona la casella di controllo per il componente di update-linux-kernel-mainline compilazione (o qualsiasi altro componente a tua scelta).

   3. Scorri verso il basso fino all'elenco dei componenti selezionati per vedere che ci sono almeno due risultati.

   4. Il controllo delle versioni dei componenti appena aggiunti potrebbe non essere esteso. Per espandere le opzioni di controllo delle versioni, puoi scegliere la freccia accanto a Opzioni di controllo delle versioni oppure puoi attivare e disattivare l'opzione Espandi tutto per espandere il controllo delle versioni per tutti i componenti selezionati.

   5. Scegliete uno dei componenti e trascinatelo verso l'alto o verso il basso per modificare l'ordine in cui i componenti verranno eseguiti.

   6. Per rimuovere il update-linux-kernel-mainline componente, scegliete X dall'angolo superiore destro della casella del componente.

   7. Ripetete il passaggio precedente per rimuovere tutti gli altri componenti che potreste aver aggiunto, lasciando selezionato solo il update-linux componente.

6. Nella sezione del modello Dockerfile, seleziona l'opzione Usa esempio. Nel pannello Contenuto, notate le variabili contestuali in cui Image Builder inserisce le informazioni di compilazione o gli script, in base alla ricetta dell'immagine del contenitore.

   Per impostazione predefinita, Image Builder utilizza le seguenti variabili contestuali nel tuo Dockerfile.

    

   ParentImage (obbligatorio)

   In fase di compilazione, questa variabile si risolve nell'immagine di base per la tua ricetta.

   Esempio:

   FROM
   {{{ imagebuilder:parentImage }}}

   ambienti (obbligatorio se vengono specificati i componenti)

   In fase di compilazione, questa variabile si risolve nelle direttive Dockerfile che inseriscono i componenti nel contesto di compilazione. Queste direttive copiano gli script dei componenti nell'immagine e impostano le variabili di ambiente utilizzate da tali script. Prepara l'ambiente ma non esegue i componenti specificati. Posiziona questa variabile prima della components variabile.

   Esempio:

   {{{ imagebuilder:environments }}}

   componenti (opzionali)

   In fase di compilazione, questa variabile si risolve nel comando che esegue gli script dei componenti di compilazione e test per i componenti inclusi nella ricetta del contenitore, quindi rimuove tali script dall'immagine. Questa è la variabile che esegue i componenti. Posizionala dopo la environments variabile.

   Esempio:

   {{{ imagebuilder:components }}}

7. Nella sezione Target repository, specifica il nome del repository Amazon ECR che hai creato come prerequisito per questo tutorial. Questo repository viene utilizzato come impostazione predefinita per la configurazione di distribuzione nella regione in cui viene eseguita la pipeline (regione 1).

   Nota

   Il repository di destinazione deve esistere in Amazon ECR per tutte le regioni di destinazione prima della distribuzione.

8. Scegli Avanti per procedere alla fase successiva.

• Scegli Avanti per procedere al passaggio successivo.

• Scegli Avanti per procedere al passaggio successivo.

1. Dopo aver esaminato le impostazioni, scegli Crea pipeline per creare la tua pipeline.

2. Puoi visualizzare i messaggi di esito positivo o negativo nella parte superiore della pagina, poiché le risorse vengono create per le impostazioni di distribuzione, la configurazione dell'infrastruttura, la nuova ricetta e la pipeline. Per visualizzare i dettagli di una risorsa, incluso l'identificatore della risorsa, scegli Visualizza dettagli.

3. Dopo aver visualizzato i dettagli di una risorsa, è possibile visualizzare i dettagli sulle altre risorse scegliendo il tipo di risorsa dal riquadro di navigazione. Ad esempio, per visualizzare i dettagli della nuova pipeline, scegli Image pipelines dal pannello di navigazione. Se la compilazione è andata a buon fine, la nuova pipeline viene visualizzata nell'elenco delle pipeline di immagini.

Elimina la pipeline

1. Per visualizzare un elenco delle pipeline di compilazione create con il tuo account, scegli Image pipelines dal pannello di navigazione.

2. Seleziona la casella di controllo accanto a Nome della pipeline per selezionare la pipeline che desideri eliminare.

3. Nella parte superiore del pannello Image pipelines, nel menu Azioni, scegliete Elimina.

4. Per confermare l'eliminazione, immettete Delete nella casella e scegliete Elimina.

Elimina la ricetta del contenitore

1. Per visualizzare un elenco delle ricette in contenitori create con il tuo account, scegli Ricette in contenitori dal pannello di navigazione.

2. Seleziona la casella di controllo accanto a Nome della ricetta per selezionare la ricetta che desideri eliminare.

3. Nella parte superiore del pannello Ricette in contenitori, nel menu Azioni, scegli Elimina ricetta.

4. Per confermare l'eliminazione, inserisci Delete nella casella e scegli Elimina.

Elimina la configurazione dell'infrastruttura

1. Per visualizzare un elenco delle configurazioni dell'infrastruttura create con il tuo account, scegli Configurazione dell'infrastruttura dal pannello di navigazione.

2. Seleziona la casella di controllo accanto a Nome della configurazione per selezionare la configurazione dell'infrastruttura che desideri eliminare.

3. Nella parte superiore del pannello Configurazioni dell'infrastruttura, scegli Elimina.

4. Per confermare l'eliminazione, inserisci Delete nella casella e scegli Elimina.

Elimina le impostazioni di distribuzione

1. Per visualizzare un elenco delle impostazioni di distribuzione create nel tuo account, scegli Impostazioni di distribuzione dal pannello di navigazione.

2. Seleziona la casella di controllo accanto a Nome della configurazione per selezionare le impostazioni di distribuzione che hai creato per questo tutorial.

3. Nella parte superiore del pannello delle impostazioni di distribuzione, scegli Elimina.

4. Per confermare l'eliminazione, inserisci Delete nella casella e scegli Elimina.

1. Per visualizzare un elenco delle immagini create con il tuo account, scegli Immagini dal pannello di navigazione.

2. Scegli la versione dell'immagine che desideri rimuovere. Si apre la pagina delle versioni di Image Build.

3. Seleziona la casella di controllo accanto alla Versione per ogni immagine che desideri eliminare. È possibile selezionare più di una versione dell'immagine alla volta.

4. Nella parte superiore del pannello delle versioni di Image build, scegli Elimina versione.

5. Per confermare l'eliminazione, inserisci Delete nella casella e scegli Elimina.