View a markdown version of this page

Edición de un servicio - AWS Proton
Edición de la descripción del servicioCómo agregar o eliminar instancias de servicio

Aviso de fin de soporte: el 7 de octubre de 2026, AWS finalizará el soporte para AWS Proton. Después del 7 de octubre de 2026, ya no podrás acceder a la AWS Proton consola ni a AWS Proton los recursos. La infraestructura implementada permanecerá intacta. Para obtener más información, consulte la Guía AWS Proton de desaprobación y migración del servicio.

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.

Edición de un servicio

Puede realizar las siguientes modificaciones en un AWS Proton servicio.

  • Edite la descripción del servicio.

  • Para editar un servicio, agregue y quite las instancias de servicio.

Edición de la descripción del servicio

Puede usar la consola o la AWS CLI para editar la descripción de un servicio.

Consola de administración de AWS

Edite un servicio mediante la consola tal y como se describe en los pasos siguientes.

En la lista de servicios.

  1. En la consola de AWS Proton, seleccione Configuración.

  2. En la lista de servicios, seleccione el botón de radio situado a la izquierda del servicio que desee actualizar.

  3. Elija Edit (Edición de).

  4. En la página Configurar servicio, rellene el formulario y seleccione Siguiente.

  5. En la página Configurar ajustes personalizados, seleccione Siguiente.

  6. Revise sus cambios y seleccione Guardar cambios.

En la página de detalles del servicio.

  1. En la consola de AWS Proton, seleccione Configuración.

  2. En la lista de servicios, elija el nombre del servicio que desee editar.

  3. En la página de detalles del servicio, seleccione Editar.

  4. En la página Configurar servicio, rellene el formulario y seleccione Siguiente.

  5. En la página Configurar ajustes personalizados, rellene el formulario y seleccione Siguiente.

  6. Revise sus cambios y seleccione Guardar cambios.

AWS CLI

Edite una descripción como se muestra en el siguiente ejemplo de comando y respuesta de la CLI.

Comando:

$ aws proton update-service \
    --name "MySimpleService" \
    --description "Edit by updating description"

Respuesta:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "branchName": "main",
        "createdAt": "2021-03-12T22:39:42.318000+00:00",
        "description": "Edit by updating description",
        "lastModifiedAt": "2021-03-12T22:44:21.975000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "my-repository/myorg-myapp",
        "status": "ACTIVE",
        "templateName": "fargate-service"
    }
}

Edite un servicio para agregar o eliminar instancias de servicio

En el caso AWS Proton de un servicio, puedes añadir o eliminar instancias de servicio enviando una especificación editada. Para que una solicitud se realice correctamente, se deben cumplir las siguientes condiciones:

  • Cuando se envía la solicitud de edición, el servicio y la canalización aún no se editan ni se eliminan.

  • La especificación editada no incluye ni las ediciones que modifican a la canalización del servicio ni las ediciones de las instancias de servicio existentes que no sean para eliminarse.

  • La especificación editada no elimina ninguna instancia de servicio existente que tenga un componente conectado. Para eliminar una instancia de servicio de este tipo, primero debe actualizar el componente para desconectarlo de su instancia de servicio. Para obtener más información sobre los componentes, consulte AWS Proton componentes.

Deletion-failed las instancias son instancias de servicio en el DELETE_FAILED estado. Cuando solicitas la edición del servicio, AWS Proton intenta eliminar automáticamente las instancias que no se han eliminado, como parte del proceso de edición. Si alguna de las instancias de servicio no se pudo eliminar, es posible que aún haya recursos asociados a dichas instancias, aunque no estén visibles desde la consola o la AWS CLI. Comprueba los recursos de infraestructura de las instancias que no se han eliminado y límpialos para que AWS Proton puedan eliminarlos por ti.

Para conocer la cuota de instancias de servicio de un servicio, consulte AWS Proton cuotas. También debe mantener al menos una instancia de servicio para el servicio después de crearlo. Durante el proceso de actualización, AWS Proton hace un recuento de las instancias de servicio existentes y de las que se van a añadir o eliminar. Deletion-failed las instancias se incluyen en este recuento y debe contabilizarlas al editar suspec.

Usa la consola o AWS CLI para agregar o eliminar instancias de servicio

Consola de administración de AWS

Edite el servicio para agregar o eliminar instancias de servicio mediante la consola.

En la consola de AWS Proton

  1. En el panel de navegación, elija Servicios.

  2. Seleccione el servicio que desee editar.

  3. Elija Edit (Edición de).

  4. (Opcional) En la página Configurar servicio, edite el nombre o la descripción del servicio y, a continuación, seleccione Siguiente.

  5. En la página Configurar ajustes personalizados, elija Eliminar para eliminar una instancia de servicio y elija Agregar nueva instancia para agregar una instancia de servicio y, por último, complete el formulario.

  6. Elija Siguiente.

  7. Revise las actualizaciones y seleccione Guardar cambios.

  8. Un modal le pedirá al usuario que verifique la eliminación de las instancias de servicio. Siga las instrucciones y seleccione Sí, eliminar.

  9. En la página de detalles del servicio, consulte los detalles del estado de su servicio.

AWS CLI

Agregue y elimine instancias de servicio con comandos y respuestas editados, spec como se muestra en el siguiente AWS CLI ejemplo.

Al utilizar la CLI, spec debe excluir las instancias de servicio que desee eliminar e incluir tanto las instancias de servicio que desee agregar como las instancias de servicio existentes que no se hayan marcado para su eliminación.

En la siguiente lista se muestra el ejemplo de spec anterior a la edición y una lista de las instancias de servicio implementadas según la especificación. Esta especificación se utilizó en el ejemplo anterior para editar la descripción de un servicio.

Especificación:

proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "abc"
  my_sample_pipeline_required_input: "123"

instances:
  - name: "my-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_optional_input: "def"
      my_sample_service_instance_required_input: "456"
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"

El siguiente ejemplo de comando y respuesta de la CLI, list-service-instances, muestra las instancias activas antes de agregar o eliminar una instancia de servicio.

Comando:

$ aws proton list-service-instances \
    --service-name "MySimpleService"

Respuesta:

{
    "serviceInstances": [
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-other-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.109000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.109000+00:00",
            "name": "my-other-instance",
            "serviceName": "example-svc",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        },
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.160000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.160000+00:00",
            "name": "my-instance",
            "serviceName": "example-svc",
            "serviceTemplateArn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        }
    ]
}

En la siguiente lista se muestra el ejemplo editado que spec utilizó para eliminar y agregar una instancia. Se elimina la instancia existente nombrada como my-instance y se agrega una nueva instancia nombrada como yet-another-instance.

Especificación:

proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "abc"
  my_sample_pipeline_required_input: "123"

instances:
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"
  - name: "yet-another-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"

Puede utilizar "${Proton::CURRENT_VAL}" para indicar qué valores de parámetros desea conservar de la spec original, si los valores existen en la spec. Utilice get-service para ver la spec original de un servicio, tal y como se describe en Visualización de datos de servicio.

La siguiente lista muestra cómo puede utilizar "${Proton::CURRENT_VAL}" para asegurarse de que spec no incluya cambios en los valores de los parámetros para que las instancias de servicios existentes permanezcan.

Especificación:

proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "${Proton::CURRENT_VAL}"
  my_sample_pipeline_required_input: "${Proton::CURRENT_VAL}"

instances:
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "${Proton::CURRENT_VAL}"
  - name: "yet-another-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"

La siguiente lista muestra el comando y la respuesta de la CLI para editar el servicio.

Comando:

$ aws proton update-service 
    --name "MySimpleService" \
    --description "Edit by adding and deleting a service instance" \
    --spec "file://spec.yaml"

Respuesta:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "branchName": "main",
        "createdAt": "2021-03-12T22:39:42.318000+00:00",
        "description": "Edit by adding and deleting a service instance",
        "lastModifiedAt": "2021-03-12T22:55:48.169000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "my-repository/myorg-myapp",
        "status": "UPDATE_IN_PROGRESS",
        "templateName": "fargate-service"
    }
}

El siguiente comando y respuesta de list-service-instances confirman que la instancia existente nombrada como my-instance se elimina y se agrega una nueva instancia nombrada como yet-another-instance.

Comando:

$ aws proton list-service-instances \
    --service-name "MySimpleService"

Respuesta:

{
    "serviceInstances": [
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/yet-another-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:56:01.565000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:56:01.565000+00:00",
            "name": "yet-another-instance",
            "serviceName": "MySimpleService",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        },
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-other-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.109000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.109000+00:00",
            "name": "my-other-instance",
            "serviceName": "MySimpleService",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        }
    ]
}

Qué ocurre cuando se agregan o se eliminan instancias de servicio

Después de enviar una edición de servicio para eliminar y agregar instancias de servicio, AWS Proton realiza las siguientes acciones.

  • Establece el servicio en UPDATE_IN_PROGRESS.

  • Si el servicio tiene una canalización, establece su estado en IN_PROGRESS y bloquea las acciones de la canalización.

  • Establece las instancias de servicio que se van a eliminar como DELETE_IN_PROGRESS.

  • Bloquea las acciones del servicio.

  • Bloquea las acciones en instancias de servicio que estén marcadas para eliminarse.

  • Crea nuevas instancias de servicio.

  • Elimina las instancias que se hayan indicado para su eliminación.

  • Intenta eliminar las instancias cuya eliminación haya producido errores.

  • Una vez se agreguen o eliminen instancias por completo, vuelve a aprovisionar la canalización de servicios (si la hubiera), establece el servicio en ACTIVE y habilita las acciones del servicio y de la canalización.

AWS Proton intenta remediar los modos de error de la siguiente manera.

  • Si no se pueden crear una o más instancias de servicio, AWS Proton intenta anular el aprovisionamiento de todas las instancias de servicio recién creadas y vuelve spec al estado anterior. No elimina ninguna instancia de servicio ni modifica la canalización de ninguna manera.

  • Si no se eliminaron una o más instancias de servicio, AWS Proton vuelva a aprovisionar la canalización sin las instancias eliminadas. La spec se actualiza para incluir las instancias agregadas y excluir las instancias que se marcaron para su eliminación.

  • Si la canalización no se aprovisiona correctamente, no se intentará revertirla y tanto el servicio como la canalización reflejarán un estado de actualización con errores.

Modificaciones de etiquetado y servicio

Cuando agregas instancias de servicio como parte de la edición del servicio, las etiquetas AWS administradas se propagan y se crean automáticamente para las nuevas instancias y los recursos aprovisionados. Si crea etiquetas nuevas, esas etiquetas solo se aplicarán a las nuevas instancias. Las etiquetas administradas por el cliente del servicio existente también se propagan a las nuevas instancias. Para obtener más información, consulte AWS Proton recursos y etiquetado.