Piattaforme personalizzate Elastic Beanstalk (ritirate)

Una piattaforma personalizzata è una personalizzazione più avanzata rispetto a una immagine personalizzata in diversi modi. Una piattaforma personalizzata ti consente di sviluppare un'intera nuova piattaforma da zero, personalizzando il sistema operativo, il software aggiuntivo e gli script che vengono eseguiti da Elastic Beanstalk sulle istanze della piattaforma. Questa flessibilità ti consente di creare una piattaforma per un'applicazione che utilizza un linguaggio o altro software dell'infrastruttura per cui Elastic Beanstalk non fornisce una piattaforma gestita. Confrontalo con immagini personalizzate, in cui modifichi un'Amazon Machine Image (AMI) per utilizzarla con una piattaforma Elastic Beanstalk esistente, ed Elastic Beanstalk fornisce comunque gli script della piattaforma e controlla lo stack software della piattaforma. Inoltre, con le piattaforme personalizzate utilizzi un metodo automatizzato e con script per creare e gestire la personalizzazione, mentre con le immagini personalizzate apporti le modifiche manualmente su un'istanza in esecuzione.

Per creare una piattaforma personalizzata, creane una AMI da uno dei sistemi operativi supportatiRHEL, Ubuntu o Amazon Linux (vedi la flavor voce Formato del file Platform.yaml per i numeri di versione esatti), e aggiungi ulteriori personalizzazioni. Puoi creare la tua piattaforma Elastic Beanstalk utilizzando Packer, uno strumento open source per la creazione di immagini di macchine per molte piattaforme, AMIs incluso l'uso con Amazon Elastic Compute Cloud (Amazon). EC2 Una piattaforma Elastic Beanstalk AMI comprende un set di software configurato per l'esecuzione che supporta un'applicazione e metadati che possono includere opzioni di configurazione personalizzate e impostazioni delle opzioni di configurazione predefinite.

Elastic Beanstalk gestisce Packer come una piattaforma integrata separata e non dovrai preoccuparti della configurazione e delle versioni di Packer.

Crei una piattaforma fornendo a Elastic Beanstalk un modello Packer e gli script e i file che il modello richiama per creare un. AMI Questi componenti sono impacchettati con un file di definizione della piattaforma, che specifica il modello e i metadati, in un archivio, noto come archivio delle definizioni della piattaforma. ZIP

Quando crei una piattaforma personalizzata, avvii un ambiente con una singola istanza senza un IP elastico che esegue Packer. Quindi, Packer avvia un'altra istanza per creare un'immagine. Puoi riutilizzare questo ambiente per più piattaforme e più versioni di ciascuna piattaforma.

Gli utenti del tuo account possono utilizzare le tue piattaforme personalizzate specificando una piattaforma ARN durante la creazione dell'ambiente. Questi ARNs vengono restituiti dal eb platform create comando che hai usato per creare la piattaforma personalizzata.

Ogni volta che compili la tua piattaforma personalizzata, Elastic Beanstalk crea una nuova versione della piattaforma. Gli utenti possono specificare una piattaforma per nome per ottenerne solo la versione più recente o includere un numero di versione per ottenere una versione specifica.

Ad esempio, per distribuire la versione più recente della piattaforma personalizzata con la ARNMyCustomPlatformARN, che potrebbe essere la versione 3.0, la riga di CLI comando EB avrebbe il seguente aspetto:

eb create -p MyCustomPlatformARN

Per implementare la versione 2.1, la riga di CLI comando EB dovrebbe essere simile a questa:

eb create -p MyCustomPlatformARN --version 2.1

Puoi applicare tag a una versione della piattaforma personalizzata al momento della sua creazione e modificare i tag di versioni della piattaforma esistenti. Per informazioni dettagliate, consultare Tagging delle versioni della piattaforma personalizzate.

Creazione di una piattaforma personalizzata

Per creare una piattaforma personalizzata, la root della tua applicazione deve includere un file di definizione della piattaforma platform.yaml che definisce il tipo di generatore utilizzato per creare la piattaforma personalizzata. Il formato di questo file è descritto in Formato del file Platform.yaml. Puoi creare la tua piattaforma personalizzata da zero oppure utilizzare una delle piattaforme personalizzate di esempio come punto di partenza.

Utilizzo di una piattaforma personalizzata di esempio

Un'alternativa alla creazione di una piattaforma personalizzata consiste nell'usare uno degli esempi dell'archivio di definizione della piattaforma per eseguire il bootstrap della piattaforma personalizzata. Gli unici elementi che dovete configurare negli esempi prima di poterli utilizzare sono una sorgente AMI e una regione.

Scarica l'archivio di definizione della piattaforma di esempio: NodePlatform_Ubuntu.zip. Questo file contiene un file di definizione della piattaforma, un modello Packer, gli script eseguiti da Packer durante la creazione di immagini e gli script e i file di configurazione che Packer copia nell'istanza del generatore durante la creazione della piattaforma.

|-- builder                 Contains files used by Packer to create the custom platform
|-- custom_platform.json    Packer template
|-- platform.yaml           Platform definition file
|-- ReadMe.txt              Briefly describes the sample

Il file di definizione della piattaforma platform.yaml indica a Elastic Beanstalk il nome del modello Packer custom_platform.json.

version: "1.0"

provisioner:
  type: packer
  template: custom_platform.json
  flavor: ubuntu1604

Il modello Packer indica a Packer come creare il file AMIs per la piattaforma, utilizzando Ubuntu AMI come base per l'immagine della piattaforma, HVM ad esempio i tipi di immagine. La sezione provisioners indica a Packer di copiare nell'istanza tutti i file della cartella builder all'interno dell'archivio e di eseguire lo script builder.sh sull'istanza. Una volta completati gli script, Packer crea un'immagine dall'istanza modificata.

Elastic Beanstalk crea tre variabili di ambiente che possono essere utilizzate per etichettare in Packer: AMIs

Il file custom_platform.json di esempio utilizza queste variabili per definire i seguenti valori utilizzati negli script:

Il file custom_platform.json contiene due proprietà di cui è necessario fornire i valori, ovvero source_ami e region. Per i dettagli sulla scelta dei valori right AMI e Region, vedi Aggiornamento del modello Packer nel repository. eb-custom-platforms-samples GitHub

{
  "variables": {
    "platform_name": "{{env `AWS_EB_PLATFORM_NAME`}}",
    "platform_version": "{{env `AWS_EB_PLATFORM_VERSION`}}",
    "platform_arn": "{{env `AWS_EB_PLATFORM_ARN`}}"
  },
  "builders": [
    {
      ...
      "region": "",
      "source_ami": "",
      ...
    }
  ],
  "provisioners": [
    {...},
    {
      "type": "shell",
      "execute_command": "chmod +x {{ .Path }}; {{ .Vars }} sudo {{ .Path }}",
      "scripts": [
        "builder/builder.sh"
      ]
    }
  ]
}

Gli script e altri file inclusi nell'archivio di definizione della piattaforma possono variare notevolmente a seconda delle modifiche che desideri apportare all'istanza. La piattaforma di esempio include i seguenti script:

Usa l'EB CLI per creare la tua prima piattaforma personalizzata con l'archivio di definizioni della piattaforma di esempio.

Al termine dell'operazione avrai una piattaforma che potrai utilizzare per avviare un ambiente Elastic Beanstalk.

Puoi utilizzare la piattaforma personalizzata durante la creazione di un ambiente dalla console. Per informazioni, consulta Procedura guidata per la creazione del nuovo ambiente.

Contenuti dell'archivio di definizione della piattaforma

Un archivio di definizione della piattaforma è l'equivalente della piattaforma di un bundle di origine dell'applicazione. L'archivio delle definizioni della piattaforma è un ZIP file che contiene un file di definizione della piattaforma, un modello Packer e gli script e i file utilizzati dal modello Packer per creare la piattaforma.

Il file di definizione della piattaforma è un file in YAML formato che deve avere un nome platform.yaml e trovarsi nella radice dell'archivio delle definizioni della piattaforma. Consultare Creazione di una piattaforma personalizzata per un elenco delle chiavi obbligatorie e facoltative supportate in un file di definizione della piattaforma.

Non devi denominare il modello Packer in un modo specifico, ma il nome del file deve corrispondere al modello dello strumento di provisioning specificato nel file di definizione della piattaforma. Per istruzioni su come creare modelli Packer, vedi la documentazione di Packer ufficiale.

Gli altri file presenti nell'archivio delle definizioni della piattaforma sono script e file utilizzati dal modello per personalizzare un'istanza prima di crearne una. AMI

Hook della piattaforma personalizzata

Elastic Beanstalk usa una struttura di directory standardizzata per gli hook su piattaforme personalizzate. Si tratta di script che vengono eseguiti durante gli eventi del ciclo di vita e in risposta alle operazioni di gestione: quando le istanze nell'ambiente vengono avviate oppure quando un utente avvia una distribuzione o usa la funzionalità di riavvio del server applicazioni.

Inserisci gli script che desideri vengano attivati dagli hook in una delle sottocartelle della cartella /opt/elasticbeanstalk/hooks/.

Gli hook sono organizzati nelle seguenti cartelle:

Le cartelle appdeploy, configdeploy e restartappserver contengono le sottocartelle pre, enact e post. In ciascuna fase di un'operazione, tutti gli script nella cartella pre vengono eseguiti in ordine alfabetico, quindi vengono eseguiti gli script nella cartella enact e infine quelli nella cartella post.

Quando viene lanciata un'istanza, Elastic Beanstalk esegue preinit, appdeploy e postinit in questo ordine. Su distribuzioni successive nelle istanze in esecuzione, Elastic Beanstalk esegue gli hook appdeploy. Gli hook configdeploy vengono eseguiti quando un utente aggiorna le impostazioni di configurazione del software sull'istanza. Gli hook restartappserver vengono eseguiti solo quando l'utente inizia il riavvio del server dell'applicazione.

Quando riscontrano errori, i tuoi script possono uscire con uno stato diverso da zero e scrivere in stderr per far fallire l'operazione. Il messaggio che scrivi in stderr apparirà nell'evento generato quando l'operazione ha esito negativo. Elastic Beanstalk è inoltre in grado di acquisire queste informazioni nel file di log /var/log/eb-activity.log. Se non desideri che l'operazione abbia esito negativo, restituisci 0. I messaggi che scrivi in stderr o stdout vengono visualizzati nei log di distribuzione, ma non nel flusso di eventi, a meno che l'operazione non abbia esito negativo.

Pulizia delle istanze Packer

In determinate circostanze, ad esempio nel caso di interruzione del processo del generatore Packer prima della conclusione, le istanze avviate da Packer non vengono eliminate. Queste istanze non fanno parte dell'ambiente Elastic Beanstalk e possono essere visualizzate e terminate solo utilizzando il servizio Amazon. EC2

Formato del file Platform.yaml

Il file platform.yaml presenta il formato seguente.

version: "version-number"

provisioner:
   type: provisioner-type
   template: provisioner-template
   flavor: provisioner-flavor
        
metadata:
   maintainer: metadata-maintainer
   description: metadata-description
   operating_system_name: metadata-operating_system_name
   operating_system_version: metadata-operating_system_version
   programming_language_name: metadata-programming_language_name
   programming_language_version: metadata-programming_language_version
   framework_name: metadata-framework_name
   framework_version: metadata-framework_version

option_definitions:
   - namespace: option-def-namespace
     option_name: option-def-option_name
     description: option-def-description
     default_value: option-def-default_value

option_settings:
   - namespace: "option-setting-namespace"
     option_name: "option-setting-option_name"
     value: "option-setting-value"

Sostituisci i segnaposto con i questi valori:

Tagging delle versioni della piattaforma personalizzate

Puoi applicare tag alle versioni AWS Elastic Beanstalk personalizzate della tua piattaforma. I tag sono coppie chiave-valore associate AWS alle risorse. Per informazioni sul tagging delle risorse, sui casi d'uso, sui vincoli delle chiavi e dei valori di tag e sui tipi di risorse supportati di Elastic Beanstalk, consulta Tagging delle risorse dell'applicazione Elastic Beanstalk.

Puoi specificare i tag al momento della creazione di una versione della piattaforma personalizzata. In una versione della piattaforma personalizzata esistente, puoi aggiungere o rimuovere i tag e aggiornare i valori dei tag esistenti. Puoi aggiungere fino a 50 tag per ogni versione della piattaforma personalizzata.

Aggiunta di tag durante la creazione della versione della piattaforma personalizzata

Se utilizzi l'EB CLI per creare la tua versione personalizzata della piattaforma, utilizza l'--tagsopzione con eb platform create per aggiungere tag.

~/workspace/my-app$ eb platform create --tags mytag1=value1,mytag2=value2

Con AWS CLI o con altri client API basati, aggiungi tag utilizzando il --tags parametro sul create-platform-version comando.

$ aws elasticbeanstalk create-platform-version \
      --tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
      --platform-name my-platform --platform-version 1.0.0 --platform-definition-bundle S3Bucket=amzn-s3-demo-bucket,S3Key=sample.zip

Gestione dei tag di una versione della piattaforma personalizzata esistente

Puoi aggiungere, aggiornare ed eliminare tag in una versione della piattaforma personalizzata Elastic Beanstalk esistente.

Se utilizzi l'EB CLI per aggiornare la versione personalizzata della tua piattaforma, eb tags usala per aggiungere, aggiornare, eliminare o elencare i tag.

Ad esempio, il comando seguente elenca i tag in una versione della piattaforma personalizzata.

~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Il comando seguente aggiorna il tag mytag1 ed elimina il tag mytag2.

~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Per un elenco completo delle opzioni e per altri esempi, consulta eb tags.

Con AWS CLI o con altri client API basati su altri, utilizzate il list-tags-for-resource comando per elencare i tag di una versione personalizzata della piattaforma.

$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Utilizza il comando update-tags-for-resource per aggiungere, aggiornare o eliminare i tag in una versione della piattaforma personalizzata.

$ aws elasticbeanstalk update-tags-for-resource \
      --tags-to-add Key=mytag1,Value=newvalue --tags-to-remove mytag2 \
      --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Specifica i tag da aggiungere e i tag da aggiornare nel parametro --tags-to-add di update-tags-for-resource. È stato aggiunto un tag non esistente e il valore di un tag esistente è stato aggiornato.

$ aws elasticbeanstalk list-platform-versions