Avvio di un progetto AWS CloudFormation Hooks personalizzato

Il primo passo per creare un progetto Hooks personalizzato è avviare il progetto. Puoi usare il CloudFormation CLI init comando per avviare il tuo progetto Hooks personalizzato.

Il init comando avvia una procedura guidata che guida l'utente nella configurazione del progetto, incluso un file di schema Hooks. Utilizzate questo file di schema come punto di partenza per definire la forma e la semantica dei vostri Hooks. Per ulteriori informazioni, consulta Sintassi dello schema.

Per avviare un progetto Hook:

1. Crea una directory per il progetto.

   mkdir ~/mycompany-testing-mytesthook

2. Passa alla nuova directory.

   cd ~/mycompany-testing-mytesthook

3. Usa il CloudFormation CLI init comando per avviare il progetto.

   cfn init

   Questo comando restituisce il seguente output.

   Initializing new project

4. Il init comando avvia una procedura guidata che guida l'utente nella configurazione del progetto. Quando richiesto, immettete h per specificare un progetto Hooks.

   Do you want to develop a new resource(r) a module(m) or a hook(h)?

   h

5. Immettete un nome per il tipo di Hook.

   What's the name of your hook type?
   (Organization::Service::Hook)

   MyCompany::Testing::MyTestHook

6. Se è installato solo un plug-in in una lingua, viene selezionato per impostazione predefinita. Se è installato più di un plug-in linguistico, puoi scegliere la lingua desiderata. Inserisci una selezione numerica per la lingua che preferisci.

   Select a language for code generation:
   [1] java
   [2] python38
   [3] python39
   (enter an integer):

7. Configura il packaging in base al linguaggio di sviluppo scelto.

   Python

   (Facoltativo) Scegli Docker per un packaging indipendente dalla piattaforma. Sebbene Docker non sia necessario, è altamente consigliato per semplificare l'imballaggio.

   Use docker for platform-independent packaging (Y/n)?
   This is highly recommended unless you are experienced with cross-platform Python packaging.

   Java

   Imposta il nome del pacchetto Java e scegli un modello codegen. È possibile utilizzare il nome del pacchetto predefinito o crearne uno nuovo.

   Enter a package name (empty for default 'com.mycompany.testing.mytesthook'):

   Choose codegen model - 1 (default) or 2 (guided-aws):

Risultati: Il progetto è stato avviato con successo e sono stati generati i file necessari per sviluppare un Hook. Quello che segue è un esempio delle directory e dei file che compongono un progetto Hooks per Python 3.8.

mycompany-testing-mytesthook.json
rpdk.log
README.md
requirements.txt
hook-role.yaml
template.yml
docs
    README.md
src
    __init__.py
    handlers.py
    models.py
    target_models
        aws_s3_bucket.py

Nota

I file nella src directory vengono creati in base alla lingua selezionata. Ci sono alcuni commenti ed esempi utili nei file generati. Alcuni file, ad esempiomodels.py, vengono aggiornati automaticamente in un passaggio successivo quando si esegue il generate comando per aggiungere codice di runtime per i gestori.