Ejemplos de artefactos

Los siguientes ejemplos muestran cómo generar, introducir y hacer referencia a los artefactos en el archivo de definición del flujo de trabajo de Amazon CodeCatalyst.

Ejemplo: Generación de un artefacto

En el siguiente ejemplo se muestra cómo generar un artefacto que incluye dos archivos .jar.

Actions:
  Build:
    Identifier: aws/build@v1
    Outputs:
      Artifacts:
        - Name: ARTIFACT1
          Files:
            - build-output/file1.jar
            - build-output/file2.jar

Ejemplo: Introducción de un artefacto generado por otra acción

En el siguiente ejemplo, se muestra cómo generar un artefacto llamado ARTIFACT4 en BuildActionA e introducirlo en BuildActionB.

Actions:
  BuildActionA:
    Identifier: aws/build@v1  
    Outputs:
      Artifacts:
        - Name: ARTIFACT4
          Files:
            - build-output/file1.jar
            - build-output/file2.jar
  BuildActionB:
    Identifier: aws/build@v1  
    Inputs:
      Artifacts:
        - ARTIFACT4
    Configuration:

Ejemplo: Referencia a archivos en varios artefactos

El siguiente ejemplo muestra cómo generar dos artefactos denominados ART5 y ART6 en BuildActionC y, a continuación, hacer referencia a dos archivos denominados file5.txt (en el artefacto ART5) y file6.txt (en el artefacto ART6) en BuildActionD (bajo Steps).

Actions:
  BuildActionC:
    Identifier: aws/build@v1  
    Outputs:
      Artifacts:
        - Name: ART5
          Files:
            - build-output/file5.txt
        - Name: ART6
          Files:
            - build-output/file6.txt
  BuildActionD:
    Identifier: aws/build@v1  
    Inputs:
      Artifacts:
        - ART5
        - ART6
    Configuration:
      Steps:
        - run: cd $CATALYST_SOURCE_DIR_ART5/build-output && cat file5.txt
        - run: cd $CATALYST_SOURCE_DIR_ART6/build-output && cat file6.txt

Ejemplo: Referencia a un archivo en un único artefacto

El siguiente ejemplo muestra cómo generar un artefacto denominado ART7 en BuildActionE y después hacer referencia a file7.txt (en el artefacto ART7) en BuildActionF (bajo Steps).

Observe que la referencia no requiere el prefijo $CATALYST_SOURCE_DIR_artifact-name delante del directorio build-output, como ocurría en Ejemplo: Referencia a archivos en varios artefactos. Esto se debe a que solo hay un elemento especificado en Inputs.

Actions:
  BuildActionE:
    Identifier: aws/build@v1  
    Outputs:
      Artifacts:
        - Name: ART7
          Files:
            - build-output/file7.txt
  BuildActionF:
    Identifier: aws/build@v1  
    Inputs:
      Artifacts:
        - ART7
    Configuration:
      Steps:
        - run: cd build-output && cat file7.txt

Ejemplo: Referencia a un archivo en un artefacto cuando WorkflowSource está presente

El siguiente ejemplo muestra cómo generar un artefacto denominado ART8 en BuildActionG y después hacer referencia a file8.txt (en el artefacto ART8) en BuildActionH (bajo Steps).

Observe que la referencia requiere el prefijo $CATALYST_SOURCE_DIR_artifact-name, como ocurría en Ejemplo: Referencia a archivos en varios artefactos. Esto se debe a que hay varios elementos especificados en Inputs (una fuente y un artefacto), por lo que necesitará el prefijo para indicar dónde buscar el archivo.

Actions:
  BuildActionG:
    Identifier: aws/build@v1  
    Outputs:
      Artifacts:
        - Name: ART8
          Files:
            - build-output/file8.txt
  BuildActionH:
    Identifier: aws/build@v1  
    Inputs:
      Sources:
        - WorkflowSource
      Artifacts:
        - ART8
    Configuration:
      Steps:
        - run: cd $CATALYST_SOURCE_DIR_ART8/build-output && cat file8.txt

Ejemplo: Referencia a un archivo en un artefacto cuando hay un grupo de acciones

El siguiente ejemplo muestra cómo generar un artefacto denominado ART9 en ActionGroup1, ActionI, y después hacer referencia a file9.txt (en el artefacto ART9) en ActionJ.

Para obtener más información sobre la referencia a archivos‎, consulte ‎Referencia a archivos en un artefacto.

Actions:
  ActionGroup1:
    Actions:
      ActionI:
        Identifier: aws/build@v1
        Outputs:
          Artifacts:
            - Name: ART9
              Files:
                - build-output/file9.yml
      ActionJ:
        Identifier: aws/cfn-deploy@v1 
        Inputs:
          Sources:
            - WorkflowSource
          Artifacts:
            - ART9
        Configuration:
          template: /artifacts/ActionGroup1@ActionJ/ART9/build-output/file9.yml