View a markdown version of this page

Esempio: pubblicazione di file su Amazon S3 - Amazon CodeCatalyst

Amazon non CodeCatalyst è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Come migrare da CodeCatalyst.

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: pubblicazione di file su Amazon S3

Il seguente flusso di lavoro di esempio include l'azione di pubblicazione di Amazon S3, insieme a un'azione di compilazione. Il flusso di lavoro crea un sito Web di documentazione statica e quindi lo pubblica su Amazon S3, dove è ospitato. Il flusso di lavoro è costituito dai seguenti elementi costitutivi che vengono eseguiti in sequenza:

  • Un trigger: questo trigger avvia l'esecuzione automatica del flusso di lavoro quando si invia una modifica al repository di origine. Per ulteriori informazioni sui trigger, consulta L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger.

  • Un'azione di creazione (BuildDocs): al momento del trigger, l'azione crea un sito Web di documentazione statica (mkdocs build) e aggiunge i file HTML associati e i metadati di supporto a un elemento chiamato. MyDocsSite Per ulteriori informazioni sull'azione di compilazione, vedere. Costruire con flussi di lavoro

  • Un'azione di pubblicazione di Amazon S3 (PublishToS3): al termine dell'azione di compilazione, questa azione copia il sito nell'MyDocsSiteartefatto in Amazon S3 per l'hosting.

Nota

Il seguente esempio di flusso di lavoro è a scopo illustrativo e non funzionerà senza una configurazione aggiuntiva.

Nota

Nel codice YAML che segue, puoi omettere la Connections: sezione se lo desideri. Se ometti questa sezione, devi assicurarti che il ruolo specificato nel campo Ruolo IAM predefinito nel tuo ambiente includa le autorizzazioni e le politiche di fiducia richieste dall'azione di pubblicazione di Amazon S3. Per ulteriori informazioni sulla configurazione di un ambiente con un ruolo IAM predefinito, consulta. Creazione di un ambiente Per ulteriori informazioni sulle autorizzazioni e le politiche di fiducia richieste dall'azione di pubblicazione di Amazon S3, consulta la descrizione della Role proprietà nel. Azione «pubblicazione Amazon S3» YAML

Name: codecatalyst-s3-publish-workflow
SchemaVersion: 1.0

Triggers:
  - Type: PUSH
    Branches:
      - main
Actions:
  BuildDocs:
    Identifier: aws/build@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      Steps:
        - Run: echo BuildDocs started on `date`
        - Run: pip install --upgrade pip
        - Run: pip install mkdocs
        - Run: mkdocs build
        - Run: echo BuildDocs completed on `date`
    Outputs:
      Artifacts:
      - Name: MyDocsSite
        Files:
          - "site/**/*"
        
  PublishToS3:
    Identifier: aws/s3-publish@v1
    Environment:
      Name: codecatalyst-s3-publish-environment
      Connections:
        - Name: codecatalyst-account-connection
          Role: codecatalyst-s3-publish-build-role
    Inputs:
      Sources:
        - WorkflowSource
      Artifacts:
        - MyDocsSite
    Configuration:      
      DestinationBucketName: amzn-s3-demo-bucket
      SourcePath: /artifacts/PublishToS3/MyDocSite/site
      TargetPath: my/docs/site