Tutorial: crea una pipeline che utilizzi Amazon S3 come provider di distribuzione

Per inviare file al tuo repository CodeCommit

1. Estrai i file di esempio scaricati. Non caricare il file ZIP nel repository.

2. Invia o carica i file nel tuo CodeCommit repository. Questi file sono l'artefatto di origine creato dalla procedura guidata Create Pipeline (Crea pipeline) per l'operazione di distribuzione in CodePipeline. I file dovrebbero avere questo aspetto nella directory locale:

   index.html
   main.css
   graphic.jpg

3. Puoi usare Git o la CodeCommit console per caricare i tuoi file:

   1. Per usare la riga di comando Git da un repository clonato sul computer locale:

      1. Esegui il comando seguente per posizionare tutti i file contemporaneamente:

         git add -A

      2. Esegui il comando seguente per eseguire il commit dei file con un messaggio di commit:

         git commit -m "Added static website files"

      3. Esegui il comando seguente per inviare i file dal repository locale al tuo CodeCommit repository:

         git push

   2. Per utilizzare la CodeCommit console per caricare i file:

      1. Apri la CodeCommit console e scegli il tuo repository dall'elenco Repository.

      2. Seleziona Add file (Aggiungi file), quindi scegli Upload file (Carica file).

      3. Seleziona Choose file (Scegli file) e vai al file. Conferma la modifica inserendo il tuo nome utente e indirizzo e-mail. Scegliere Commit changes (Applica modifiche).

      4. Ripeti questa fase per ogni file da caricare.

Per creare una pipeline con la procedura guidata

1. Accedi AWS Management Console e apri la CodePipeline console all'indirizzo http://console.aws.amazon. com/codesuite/codepipeline/home.

2. Nella pagina Welcome (Benvenuto), pagina Getting started (Nozioni di base) o pagina Pipelines (Pipeline), scegli Create pipeline (Crea pipeline).

3. Nella pagina Passaggio 1: Scegli l'opzione di creazione, in Opzioni di creazione, scegli l'opzione Crea pipeline personalizzata. Scegli Next (Successivo).

4. Nel Passaggio 2: Scegliete le impostazioni della pipeline, in Nome della tubazione, immettete. MyS3DeployPipeline

5. In Tipo di tubazione, scegliete V2. Per ulteriori informazioni, consulta Tipi di tubazioni. Scegli Next (Successivo).

6. In Ruolo di servizio, scegli Nuovo ruolo di servizio per consentire la creazione CodePipeline di un ruolo di servizio in IAM.

7. Lasciare i valori predefiniti delle impostazioni in Advanced settings (Impostazioni avanzate), quindi scegliere Next (Successivo).

8. Nel passaggio 3: Aggiungi la fase di origine, in Provider di origine, scegli AWS CodeCommit. In Repository name (Nome repository), scegliere il nome del repository CodeCommit creato in Passaggio 1: crea un CodeCommit repository. In Branch name (Nome ramo), scegliere il nome del ramo che contiene l'aggiornamento di codice più recente. Se l'utente non ha creato personalmente un ramo diverso, è disponibile solo main.

   Dopo aver selezionato il nome e il ramo del repository, viene visualizzata la regola Amazon CloudWatch Events da creare per questa pipeline.

   Scegli Next (Successivo).

9. Nel passaggio 4: aggiungi la fase di creazione, scegli Ignora fase di creazione, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora.

   Scegli Next (Successivo).

10. Nel passaggio 5: aggiungi la fase di test, scegli Ignora fase di test, quindi accetta il messaggio di avviso scegliendo nuovamente Ignora.

    Scegli Next (Successivo).

11. Nel passaggio 6: aggiungi la fase di implementazione:

    1. In Deploy provider (Provider di distribuzione), scegli Amazon S3.

    2. In Bucket, inserisci il nome del bucket pubblico.

    3. Seleziona Extract file before deploy (Estrai file prima di distribuire).

       Nota

       La distribuzione non riesce se non selezioni Estrai il file prima di distribuire Questo perché l' AWS CodeCommit azione nella pipeline comprime gli artefatti di origine e il file è un file ZIP.

       Quando Extract file before deploy (Estrai file prima di distribuire) è selezionato, viene visualizzato Deployment path (Percorso di distribuzione). Inserisci il nome del percorso che vuoi utilizzare. Questo crea una struttura di cartelle in Amazon S3 in cui vengono estratti i file. Per questo tutorial, lascia questo campo vuoto.

       

    4. (Facoltativo) In Canned ACL (ACL predefinita), puoi applicare un set di concessioni predefinite, note come ACL predefinita, agli artefatti caricati.

    5. (Facoltativo) In Cache control (Controllo cache), immetti i parametri della memorizzazione nella cache. Con questa impostazione puoi controllare il comportamento della memorizzazione nella cache per le richieste/risposte. Per i valori validi, vedi il campo di intestazione Cache-Control per le operazioni HTTP.

    6. Scegli Next (Successivo).

12. Nel passaggio 7: rivedi, esamina le informazioni, quindi scegli Crea pipeline.

13. Una volta eseguita correttamente la pipeline, apri la console Amazon S3 e verifica che i file vengano visualizzati nel bucket pubblico come mostrato:

    index.html
    main.css
    graphic.jpg

14. Accedi all'endpoint per testare il sito Web. L'endpoint segue questo formato: http://bucket-name.s3-website-region.amazonaws.com/.

    Endpoint di esempio: http://my-bucket.s3-website-us-west-2.amazonaws.com/

    Viene visualizzata la pagina Web di esempio.

Per creare un file buildspec.yml

• Crea un file denominato buildspec.yml con i seguenti contenuti. Questi comandi di compilazione installano TypeScript e utilizzano il TypeScript compilatore per riscrivere il codice in index.ts codice. JavaScript

  version: 0.2
  
  phases:
    install:
      commands:
        - npm install -g typescript
    build:
      commands:
        - tsc index.ts
  artifacts:
    files:
      - index.js

Per creare un file index.ts

• Crea un file denominato index.ts con i seguenti contenuti.

  interface Greeting {
      message: string;
  }
  
  class HelloGreeting implements Greeting {
      message = "Hello!";
  }
  
  function greet(greeting: Greeting) {
      console.log(greeting.message);
  }
  
  let greeting = new HelloGreeting();
  
  greet(greeting);

Per caricare i file nel bucket di origine S3

1. I file dovrebbero avere questo aspetto nella directory locale:

   buildspec.yml
   index.ts

   Comprimi i file e assegna al file il nome source.zip.

2. Nella console Amazon S3, per il tuo bucket di origine, scegli Upload. Scegli Add files (Aggiungi file), quindi individua il file ZIP creato.

3. Scegli Carica. Questi file sono l'artefatto di origine creato dalla procedura guidata Create Pipeline (Crea pipeline) per l'operazione di distribuzione in CodePipeline. Il file dovrebbe avere questo aspetto nel bucket:

   source.zip

Per creare una pipeline con la procedura guidata

1. Accedi AWS Management Console e apri la CodePipeline console all'indirizzo http://console.aws.amazon. com/codesuite/codepipeline/home.

2. Nella pagina Welcome (Benvenuto), pagina Getting started (Nozioni di base) o pagina Pipelines (Pipeline), scegli Create pipeline (Crea pipeline).

3. Nella pagina Passaggio 1: Scegli l'opzione di creazione, in Opzioni di creazione, scegli l'opzione Crea pipeline personalizzata. Scegli Next (Successivo).

4. Nel Passaggio 2: Scegliete le impostazioni della pipeline, in Nome della tubazione, immettete. MyS3DeployPipeline

5. In Ruolo di servizio, scegli Nuovo ruolo di servizio per consentire la creazione CodePipeline di un ruolo di servizio in IAM.

6. Lasciare i valori predefiniti delle impostazioni in Advanced settings (Impostazioni avanzate), quindi scegliere Next (Successivo).

7. Nel passaggio 3: Aggiungi la fase di origine, in Provider di origine, scegli Amazon S3. In Bucket, scegli il nome del bucket di origine. In S3 object key (Chiave oggetto S3), inserisci il nome del file ZIP di origine. Assicurati di includere l'estensione del file.zip.

   Scegli Next (Successivo).

8. Nel passaggio 4: aggiungi la fase di compilazione:

   1. In Build provider (Provider compilazione), scegli CodeBuild.

   2. Scegliere Create build project (Crea progetto di compilazione). Nella pagina Create project (Crea progetto):

   3. In Project name (Nome progetto) immettere un nome per questo progetto di compilazione.

   4. In Environment (Ambiente), scegliere Managed image (Immagine gestita). In Operating system (Sistema operativo), seleziona Ubuntu.

   5. In Runtime, seleziona Standard. Per la versione Runtime, scegliere:1.0aws/codebuild/standard.

   6. In Image version (Versione immagine), scegli Always use the latest image for this runtime version (Usa sempre l'immagine più recente per questa versione di runtime).

   7. Per Ruolo di servizio, scegli il tuo ruolo di CodeBuild servizio o creane uno.

   8. Per Build specifications (Compila specifiche), scegli Use a buildspec file (Usa un file buildspec).

   9. Scegli Continua a CodePipeline. Viene visualizzato un messaggio se il progetto è stato creato correttamente.

   10. Scegli Next (Successivo).

9. Nel passaggio 5: aggiungi la fase di distribuzione:

   1. In Deploy provider (Provider di distribuzione), scegli Amazon S3.

   2. In Bucket, inserisci il nome del bucket di destinazione S3.

   3. Assicurati che Extract file before deploy (Estrai file prima di distribuire) sia deselezionato.

      Quando Extract file before deploy (Estrai file prima di distribuire) è deselezionato, viene visualizzato S3 object key (Chiave oggetto S3). Inserisci il nome del percorso che vuoi utilizzare: js-application/{datetime}.zip.

      Questo crea una js-application cartella in Amazon S3 in cui vengono estratti i file. In questa cartella, la variabile {datetime} crea un timestamp su ciascun file di output quando la pipeline viene eseguita.

      

   4. (Facoltativo) In Canned ACL (ACL predefinita), puoi applicare un set di concessioni predefinite, note come ACL predefinita, agli artefatti caricati.

   5. (Facoltativo) In Cache control (Controllo cache), immetti i parametri della memorizzazione nella cache. Con questa impostazione puoi controllare il comportamento della memorizzazione nella cache per le richieste/risposte. Per i valori validi, vedi il campo di intestazione Cache-Control per le operazioni HTTP.

   6. Scegli Next (Successivo).

10. Nel passaggio 6: esamina, esamina le informazioni, quindi scegli Crea pipeline.

11. Una volta eseguita correttamente la pipeline, visualizza il bucket nella console Amazon S3. Verifica che il file ZIP distribuito sia visualizzato nel bucket di destinazione nella cartella js-application. Il JavaScript file contenuto nel file ZIP dovrebbe essere. index.js Il file index.js contiene il seguente output:

    var HelloGreeting = /** @class */ (function () {
        function HelloGreeting() {
            this.message = "Hello!";
        }
        return HelloGreeting;
    }());
    function greet(greeting) {
        console.log(greeting.message);
    }
    var greeting = new HelloGreeting();
    greet(greeting);