Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# AppSpec Ejemplo de archivo
En este tema se proporcionan AppSpec archivos de ejemplo para una implementación AWS Lambda y una implementación local de EC2.
**Topics**
+ [AppSpec Ejemplo de archivo para una implementación de Amazon ECS](#appspec-file-example-ecs)
+ [AppSpec Ejemplo de archivo para una implementación de AWS Lambda](#appspec-file-example-lambda)
+ [AppSpec Ejemplo de archivo para una implementación local de EC2/](#appspec-file-example-server)
## AppSpec Ejemplo de archivo para una implementación de Amazon ECS
A continuación, se muestra un ejemplo de un AppSpec archivo escrito en YAML para implementar un servicio de Amazon ECS.
```
version: 0.0
Resources:
- TargetService:
Type: AWS::ECS::Service
Properties:
TaskDefinition: "arn:aws:ecs:us-east-1:111222333444:task-definition/my-task-definition-family-name:1"
LoadBalancerInfo:
ContainerName: "SampleApplicationName"
ContainerPort: 80
# Optional properties
PlatformVersion: "LATEST"
NetworkConfiguration:
AwsvpcConfiguration:
Subnets: ["subnet-1234abcd","subnet-5678abcd"]
SecurityGroups: ["sg-12345678"]
AssignPublicIp: "ENABLED"
CapacityProviderStrategy:
- Base: 1
CapacityProvider: "FARGATE_SPOT"
Weight: 2
- Base: 0
CapacityProvider: "FARGATE"
Weight: 1
Hooks:
- BeforeInstall: "LambdaFunctionToValidateBeforeInstall"
- AfterInstall: "LambdaFunctionToValidateAfterInstall"
- AfterAllowTestTraffic: "LambdaFunctionToValidateAfterTestTrafficStarts"
- BeforeAllowTraffic: "LambdaFunctionToValidateBeforeAllowingProductionTraffic"
- AfterAllowTraffic: "LambdaFunctionToValidateAfterAllowingProductionTraffic"
```
Esta es una versión del ejemplo anterior escrita en JSON.
```
{
"version": 0.0,
"Resources": [
{
"TargetService": {
"Type": "AWS::ECS::Service",
"Properties": {
"TaskDefinition": "arn:aws:ecs:us-east-1:111222333444:task-definition/my-task-definition-family-name:1",
"LoadBalancerInfo": {
"ContainerName": "SampleApplicationName",
"ContainerPort": 80
},
"PlatformVersion": "LATEST",
"NetworkConfiguration": {
"AwsvpcConfiguration": {
"Subnets": [
"subnet-1234abcd",
"subnet-5678abcd"
],
"SecurityGroups": [
"sg-12345678"
],
"AssignPublicIp": "ENABLED"
}
},
"CapacityProviderStrategy": [
{
"Base" : 1,
"CapacityProvider" : "FARGATE_SPOT",
"Weight" : 2
},
{
"Base" : 0,
"CapacityProvider" : "FARGATE",
"Weight" : 1
}
]
}
}
}
],
"Hooks": [
{
"BeforeInstall": "LambdaFunctionToValidateBeforeInstall"
},
{
"AfterInstall": "LambdaFunctionToValidateAfterInstall"
},
{
"AfterAllowTestTraffic": "LambdaFunctionToValidateAfterTestTrafficStarts"
},
{
"BeforeAllowTraffic": "LambdaFunctionToValidateBeforeAllowingProductionTraffic"
},
{
"AfterAllowTraffic": "LambdaFunctionToValidateAfterAllowingProductionTraffic"
}
]
}
```
A continuación se muestra la secuencia de eventos durante la implementación:
1. Antes de instalar la aplicación de Amazon ECS actualizada en el conjunto de tareas de sustitución, se ejecuta la función de Lambda denominada `LambdaFunctionToValidateBeforeInstall`.
1. Una vez instalada la aplicación de Amazon ECS actualizada en el conjunto de tareas de sustitución, pero antes de recibir tráfico, se ejecuta la función de Lambda denominada `LambdaFunctionToValidateAfterInstall`.
1. Después de que la aplicación de Amazon ECS en el conjunto de tareas de sustitución empieza a recibir tráfico del oyente de prueba, se ejecuta la función de Lambda denominada `LambdaFunctionToValidateAfterTestTrafficStarts`. Esta función probablemente ejecuta pruebas de validación para determinar si la implementación continúa. Si no especifica un agente de escucha de prueba en el grupo de implementaciones, esta se omite.
1. Después de completar las pruebas de validación en el enlace `AfterAllowTestTraffic` y antes de enviar tráfico de producción a la aplicación de Amazon ECS actualizada, se ejecuta la función de Lambda denominada `LambdaFunctionToValidateBeforeAllowingProductionTraffic`.
1. Después de enviar tráfico de producción a la aplicación de Amazon ECS actualizada en el conjunto de tareas de sustitución, se ejecuta la función de Lambda denominada `LambdaFunctionToValidateAfterAllowingProductionTraffic`.
Las funciones de Lambda que se ejecutan durante cualquier enlace pueden llevar a cabo pruebas de validación o recopilar métricas de tráfico.
## AppSpec Ejemplo de archivo para una implementación de AWS Lambda
Este es un ejemplo de un AppSpec archivo escrito en YAML para implementar una versión de la función Lambda.
```
version: 0.0
Resources:
- myLambdaFunction:
Type: AWS::Lambda::Function
Properties:
Name: "myLambdaFunction"
Alias: "myLambdaFunctionAlias"
CurrentVersion: "1"
TargetVersion: "2"
Hooks:
- BeforeAllowTraffic: "LambdaFunctionToValidateBeforeTrafficShift"
- AfterAllowTraffic: "LambdaFunctionToValidateAfterTrafficShift"
```
Esta es una versión del ejemplo anterior escrita en JSON.
```
{
"version": 0.0,
"Resources": [{
"myLambdaFunction": {
"Type": "AWS::Lambda::Function",
"Properties": {
"Name": "myLambdaFunction",
"Alias": "myLambdaFunctionAlias",
"CurrentVersion": "1",
"TargetVersion": "2"
}
}
}],
"Hooks": [{
"BeforeAllowTraffic": "LambdaFunctionToValidateBeforeTrafficShift"
},
{
"AfterAllowTraffic": "LambdaFunctionToValidateAfterTrafficShift"
}
]
}
```
A continuación se muestra la secuencia de eventos durante la implementación:
1. Antes de desviar el tráfico de la versión 1 de la función de Lambda llamada `myLambdaFunction` a la versión 2, ejecute una función de Lambda llamada `LambdaFunctionToValidateBeforeTrafficShift` que valide que la implementación está lista para empezar a desviar el tráfico.
1. Si `LambdaFunctionToValidateBeforeTrafficShift` devuelve un código de salida de 0 (éxito), se empieza a desviar el tráfico a la versión 2 de `myLambdaFunction`. La configuración de esta implementación determina la velocidad a la que se desvía el tráfico.
1. Una vez completado el desvío de tráfico de la versión 1 de la función de Lambda llamada `myLambdaFunction` a la versión 2, ejecute una función de Lambda llamada `LambdaFunctionToValidateAfterTrafficShift` que valide que la implementación se ha realizado correctamente.
## AppSpec Ejemplo de archivo para una implementación local de EC2/
Este es un ejemplo de un AppSpec archivo para una implementación local en una instancia de Amazon Linux, Ubuntu Server o RHEL.
**nota**
Las implementaciones en instancias de Windows Server no admiten el elemento `runas`. Si va a realizar una implementación en instancias de Windows Server, no lo incluya en el archivo AppSpec .
```
version: 0.0
os: linux
files:
- source: Config/config.txt
destination: /webapps/Config
- source: source
destination: /webapps/myApp
hooks:
BeforeInstall:
- location: Scripts/UnzipResourceBundle.sh
- location: Scripts/UnzipDataBundle.sh
AfterInstall:
- location: Scripts/RunResourceTests.sh
timeout: 180
ApplicationStart:
- location: Scripts/RunFunctionalTests.sh
timeout: 3600
ValidateService:
- location: Scripts/MonitorService.sh
timeout: 3600
runas: codedeployuser
```
Para una instancia de Windows Server, cambie `os: linux` por `os: windows`. Además, las rutas de `destination` deben ser completas (por ejemplo, `c:\temp\webapps\Config` y `c:\temp\webapps\myApp`). No incluya el elemento `runas`.
A continuación se muestra la secuencia de eventos durante la implementación:
1. Ejecutar el script que se encuentra en `Scripts/UnzipResourceBundle.sh`.
1. Si el script anterior devuelve un código de salida de 0 (éxito), ejecutar el script ubicado en `Scripts/UnzipDataBundle.sh`.
1. Copiar el archivo desde la ruta de `Config/config.txt` a la ruta `/webapps/Config/config.txt`.
1. Copiar recursivamente todos los archivos del directorio `source` en el directorio `/webapps/myApp`.
1. Ejecutar el script ubicado en `Scripts/RunResourceTests.sh` con un tiempo de espera de 180 segundos (3 minutos).
1. Ejecutar el script ubicado en `Scripts/RunFunctionalTests.sh` con un tiempo de espera de 3 600 segundos (1 hora).
1. Ejecutar el script ubicado en `Scripts/MonitorService.sh` como el usuario `codedeploy` con un tiempo de espera de 3 600 segundos (1 hora).