Questa è la guida per sviluppatori AWS CDK v2. La versione precedente della CDK versione 1 è entrata in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Esempio: creare un AWS Fargate servizio utilizzando AWS CDK
In questo esempio, ti mostriamo come creare un AWS Fargate (Fargate) servizio in esecuzione su un cluster Amazon Elastic Container Service (AmazonECS) gestito da un Application Load Balancer connesso a Internet da un'immagine su Amazon. ECR
Amazon ECS è un servizio di gestione dei container altamente scalabile e veloce che semplifica l'esecuzione, l'arresto e la gestione dei Docker container su un cluster. Puoi ospitare il tuo cluster su un'infrastruttura serverless gestita da Amazon ECS avviando i tuoi servizi o attività utilizzando il tipo di lancio Fargate. Per un maggiore controllo, puoi ospitare le tue attività su un cluster di istanze Amazon Elastic Compute Cloud (AmazonEC2) che gestisci utilizzando il tipo di EC2 avvio di Amazon.
In questo esempio, lanciamo alcuni servizi utilizzando il tipo di lancio Fargate. Se hai utilizzato il AWS Management Console per creare un servizio Fargate, sai che ci sono molti passaggi da seguire per eseguire tale operazione. AWS contiene diversi tutorial e argomenti di documentazione che illustrano la creazione di un servizio Fargate, tra cui:
Questo esempio crea un servizio Fargate simile utilizzando. AWS CDK
Il ECS costrutto Amazon utilizzato in questo esempio ti aiuta a utilizzare AWS i servizi offrendo i seguenti vantaggi:
-
Configura automaticamente un sistema di bilanciamento del carico.
-
Apre automaticamente un gruppo di sicurezza per i sistemi di bilanciamento del carico. Ciò consente ai sistemi di bilanciamento del carico di comunicare con le istanze senza dover creare esplicitamente un gruppo di sicurezza.
-
Ordina automaticamente la dipendenza tra il servizio e il sistema di bilanciamento del carico collegato a un gruppo target, applicando l'ordine corretto di creazione del AWS CDK listener prima della creazione di un'istanza.
-
Configura automaticamente i dati degli utenti su gruppi di ridimensionamento automatico. Questo crea la configurazione corretta a cui associare un cluster. AMIs
-
Convalida anticipatamente le combinazioni di parametri. Ciò espone i AWS CloudFormation problemi prima, risparmiando così i tempi di implementazione. Ad esempio, a seconda dell'attività, è facile configurare in modo errato le impostazioni della memoria. In precedenza, non si verificava alcun errore fino a quando non avessimo distribuito la nostra app. Ma ora AWS CDK possono rilevare una configurazione errata ed emettere un errore quando sintetizziamo la nostra app.
-
Aggiunge automaticamente le autorizzazioni per Amazon Elastic Container Registry (AmazonECR) se utilizziamo un'immagine di AmazonECR.
-
Ridimensiona automaticamente. AWS CDK Fornisce un metodo che ci consente di scalare automaticamente le istanze quando utilizziamo un EC2 cluster Amazon. Ciò avviene automaticamente quando utilizziamo un'istanza in un cluster Fargate.
Inoltre, AWS CDK impedisce l'eliminazione di un'istanza quando il ridimensionamento automatico tenta di arrestare un'istanza, ma un'attività è in esecuzione o è pianificata su quell'istanza.
In precedenza, dovevamo creare una funzione Lambda per avere questa funzionalità.
-
Fornisce supporto per gli asset, in modo da poter distribuire una fonte dalla nostra macchina ad Amazon ECS in un unico passaggio. In precedenza, per utilizzare una fonte di applicazione, dovevamo eseguire diversi passaggi manuali, come il caricamento su Amazon ECR e la creazione di un'Dockerimmagine.
Importante
ApplicationLoadBalancedFargateService
I costrutti che useremo includono numerosi AWS
componenti, alcuni dei quali hanno costi non banali se lasciati disponibili nel nostro AWS account, anche se non li utilizziamo. Assicurati di usare clean up (cdk destroy) se segui questo esempio.
Crea un CDK progetto
Iniziamo con la creazione di un CDK progetto. Questa è una directory che memorizza il nostro AWS CDK codice, inclusa la nostra CDK app.
Successivamente, eseguiamo l'app e confermiamo che crea uno stack vuoto.
cdk synth
Creare un servizio Fargate
Esistono due modi diversi in cui possiamo eseguire le nostre attività relative ai container con AmazonECS:
-
Utilizza il tipo di
Fargate
avvio, in cui Amazon ECS gestisce per noi le macchine fisiche su cui vengono eseguiti i nostri container. -
Usa il tipo di
EC2
avvio, dove ci occupiamo della gestione, ad esempio specificando il ridimensionamento automatico.
Per questo esempio, creeremo un servizio Fargate in esecuzione su un ECS cluster Amazon, gestito da un Application Load Balancer con accesso a Internet.
Aggiungiamo le seguenti importazioni del modulo AWS Construct Library al nostro file stack:
All'interno del nostro stack, aggiungiamo il seguente codice:
Successivamente, convalidiamo il nostro codice eseguendo quanto segue per sintetizzare il nostro stack:
cdk synth
Lo stack è composto da centinaia di righe, quindi non lo mostreremo qui. Lo stack deve contenere un'istanza predefinita, una sottorete privata e una sottorete pubblica per le tre zone di disponibilità e un gruppo di sicurezza.
Per distribuire lo stack, eseguiamo quanto segue:
cdk deploy
AWS CloudFormation mostra informazioni sulle dozzine di passaggi necessari per l'implementazione della nostra app.
Una volta completata l'implementazione, abbiamo creato con successo un servizio ECS Amazon basato su Fargate per eseguire Docker un'immagine.
Eliminazione
Come best practice di manutenzione generale e per ridurre al minimo i costi non necessari, eliminiamo il nostro stack una volta completato:
cdk destroy