

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.

# Creación y asociación de configuraciones de ciclo de vida
<a name="studio-lifecycle-configurations-create"></a>

Puede crear y adjuntar configuraciones de ciclo de vida utilizando el Consola de administración de AWS o el AWS Command Line Interface.

**Topics**
+ [Creación y asociación de configuraciones de ciclo de vida (AWS CLI)](#studio-lifecycle-configurations-create-cli)
+ [Creación y asociación de configuraciones de ciclo de vida (consola)](#studio-lifecycle-configurations-create-console)

## Creación y asociación de configuraciones de ciclo de vida (AWS CLI)
<a name="studio-lifecycle-configurations-create-cli"></a>

**importante**  
Antes de comenzar, complete los siguientes requisitos previos:   
 AWS CLI Actualícela siguiendo los pasos que se indican en [Instalación de la AWS CLI versión actual](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled).
Desde su máquina local, ejecute `aws configure` y proporcione sus AWS credenciales. Para obtener información sobre AWS las credenciales, consulte [Descripción y obtención de AWS las credenciales](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html). 
Incorporado al dominio Amazon SageMaker AI. Para obtener información conceptual, consulte [Descripción general del dominio Amazon SageMaker AI](gs-studio-onboard.md). Para obtener una guía de inicio rápido, consulte [Utilice la configuración rápida para Amazon SageMaker AI](onboard-quick-start.md).

El siguiente procedimiento muestra cómo crear un script de configuración del ciclo de vida que se imprima `Hello World` en el editor de código o JupyterLab.

**nota**  
Cada script puede tener hasta **16 384 caracteres**.

1. En su equipo local, cree un archivo con el nombre `my-script.sh` que contenga lo siguiente:

   ```
   #!/bin/bash
   set -eux
   echo 'Hello World!'
   ```

1. Utilice lo siguiente para convertir su archivo `my-script.sh` al formato base64. Este requisito evita errores debidos a la codificación del espaciado y los saltos de línea.

   ```
   LCC_CONTENT=`openssl base64 -A -in my-script.sh`
   ```

1. Cree una configuración del ciclo de vida para usar en Studio. Con el siguiente comando se crea una configuración de ciclo de vida que se ejecuta al inicializar una aplicación de `JupyterLab` asociada:

   ```
   aws sagemaker create-studio-lifecycle-config \
   --region region \
   --studio-lifecycle-config-name my-lcc \
   --studio-lifecycle-config-content $LCC_CONTENT \
   --studio-lifecycle-config-app-type application-type
   ```

   En `studio-lifecycle-config-app-type`, especifique *CodeEditor* o *JupyterLab*.
**nota**  
El ARN de la configuración de ciclo de vida recién creada que se devuelve. Este ARN es necesario para asociar la configuración del ciclo de vida a la aplicación.

Para garantizar que los entornos se personalicen correctamente, los usuarios y los administradores utilizan diferentes comandos para asociar las configuraciones de ciclo de vida.

### Asociación de configuraciones de ciclo de vida predeterminadas (administrador)
<a name="studio-lifecycle-configurations-attach-cli-administrator"></a>

Para asociar la configuración de ciclo de vida, debe actualizar la `UserSettings` de su dominio o perfil de usuario. Todos los usuarios heredan los scripts de configuración del ciclo de vida que estén asociados a nivel de dominio. Sin embargo, los scripts que están asociados en el nivel de perfil de usuario están dirigidos a un usuario específico. 

Para crear un perfil de usuario, un dominio o un espacio con la configuración de ciclo de vida asociada, utilice los siguientes comandos:
+ [create-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-user-profile.html)
+ [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-domain.html)
+ [create-space](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-space.html)

El siguiente comando crea un perfil de usuario con una configuración del ciclo de vida de una JupyterLab aplicación. Agregue el ARN de configuración de ciclo de vida del paso anterior a la `JupyterLabAppSettings` del usuario. Puede agregar varias configuraciones de ciclo de vida al mismo tiempo pasando una lista de ellas. Cuando un usuario inicia una JupyterLab aplicación con AWS CLI, puede especificar una configuración de ciclo de vida en lugar de utilizar la configuración predeterminada. La configuración del ciclo de vida que pase el usuario debe pertenecer a la lista de configuraciones del ciclo de vida incluida en la `JupyterLabAppSettings`.

```
# Create a new UserProfile
aws sagemaker create-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"JupyterLabAppSettings": {
  "LifecycleConfigArns":
    [lifecycle-configuration-arn-list]
  }
}'
```

Con el siguiente comando, se crea un perfil de usuario con una configuración de ciclo de vida de una aplicación del editor de código. Agregue el ARN de configuración de ciclo de vida del paso anterior a la `CodeEditorAppSettings` del usuario. Puede agregar varias configuraciones de ciclo de vida al mismo tiempo pasando una lista de ellas. Cuando un usuario inicializa una aplicación del editor de código con la AWS CLI, puede especificar una configuración de ciclo de vida en lugar de usar la predeterminada. La configuración del ciclo de vida que pase el usuario debe pertenecer a la lista de configuraciones del ciclo de vida incluida en la `CodeEditorAppSettings`.

```
# Create a new UserProfile
aws sagemaker create-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"CodeEditorAppSettings": {
  "LifecycleConfigArns":
    [lifecycle-configuration-arn-list]
  }
}'
```

### Asociación de configuraciones de ciclo de vida integradas (usuario)
<a name="studio-lifecycle-configurations-attach-cli-user"></a>

Para asociar la configuración de ciclo de vida, debe actualizar la `UserSettings` de su perfil de usuario.

El siguiente comando crea un perfil de usuario con una configuración del ciclo de vida de una JupyterLab aplicación. Agregue el ARN de configuración de ciclo de vida del paso anterior a la `JupyterLabAppSettings` del perfil de usuario.

```
# Update a UserProfile
aws sagemaker update-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"JupyterLabAppSettings": {
  "BuiltInLifecycleConfigArn":"lifecycle-configuration-arn"
  }
}'
```

Con el siguiente comando, se crea un perfil de usuario con una configuración de ciclo de vida de una aplicación del editor de código. Agregue el ARN de configuración de ciclo de vida del paso anterior a la `CodeEditorAppSettings` del perfil de usuario. La configuración del ciclo de vida que pase el usuario debe pertenecer a la lista de configuraciones del ciclo de vida incluida en la `CodeEditorAppSettings`.

```
# Update a UserProfile
aws sagemaker update-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"CodeEditorAppSettings": {
  "BuiltInLifecycleConfigArn":"lifecycle-configuration-arn"
  }
}'
```

## Creación y asociación de configuraciones de ciclo de vida (consola)
<a name="studio-lifecycle-configurations-create-console"></a>

Para crear y adjuntar configuraciones de ciclo de vida en Consola de administración de AWS, navegue hasta la [consola de Amazon SageMaker AI](https://console.aws.amazon.com/sagemaker) y elija **Configuraciones de ciclo** de vida en el menú de navegación de la izquierda. La consola le guiará a lo largo del proceso de creación de la configuración de ciclo de vida.