

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.

# Descargue y configure Edge Manager
<a name="edge-getting-started-step4"></a>

El agente de Edge Manager es un motor de inferencia para sus dispositivos periféricos. Utilice el agente para realizar predicciones con los modelos cargados en sus dispositivos periféricos. El agente también recopila las métricas del modelo y captura los datos a intervalos específicos.



En esta sección, configurará su dispositivo con el agente. Para ello, primero copie un artefacto de versión y un certificado raíz de firma del bucket de versión de forma local en su máquina. Después de haber descomprimido el artefacto de versión, cárguelo en Amazon S3. A continuación, defina y guarde un archivo de configuración para el agente. Se proporciona una plantilla para que la copie y pegue. Por último, copie los artefactos de versión, el archivo de configuración y las credenciales en su dispositivo.

1. **Descarga el agente de SageMaker Edge Manager.**

   El agente se publica en formato binario para los sistemas operativos compatibles. En este ejemplo se realiza una inferencia en un Jetson Nano que utiliza un sistema operativo Linux y tiene una arquitectura ARM64. Para obtener más información sobre el sistema operativo y la arquitectura que utilizan los dispositivos compatibles, consulte [Marcos, dispositivos, sistemas y arquitecturas compatibles](neo-supported-devices-edge-devices.md).

   Obtenga la última versión de los binarios del paquete de versiones de SageMaker Edge Manager de la región us-west-2.

   ```
   !aws s3 ls s3://sagemaker-edge-release-store-us-west-2-linux-armv8/Releases/ | sort -r
   ```

   Esto muestra los artefactos de versión ordenados por su correspondiente.

   ```
                              PRE 1.20210512.96da6cc/
                              PRE 1.20210305.a4bc999/
                              PRE 1.20201218.81f481f/
                              PRE 1.20201207.02d0e97/
   ```

   La versión tiene el siguiente formato: `<MAJOR_VERSION>.<YYYY-MM-DD>.<SHA-7>`. Consta de tres componentes:
   + `<MAJOR_VERSION>`: Versión de lanzamiento. La versión de lanzamiento está configurada actualmente en `1`.
   + `<YYYY-MM-DD>`: La marca de tiempo de versión del artefacto.
   + < SHA-7 >: El ID de confirmación del repositorio a partir del cual se creó la versión.

   Copie el archivo TAR comprimido localmente o directamente en su dispositivo. En el siguiente ejemplo se muestra cómo copiar el artefacto de versión más reciente en el momento de publicación de este documento.

   ```
   !aws s3 cp s3://sagemaker-edge-release-store-us-west-2-linux-x64/Releases/1.20201218.81f481f/1.20201218.81f481f.tgz ./
   ```

   Una vez que tenga el artefacto, descomprima el archivo TAR. Lo siguiente descomprime el archivo TAR y lo almacena en un directorio llamado `agent_demo`:

   ```
   !mkdir agent_demo
   !tar -xvzf 1.20201218.81f481f.tgz -C ./agent_demo
   ```

   Cargue los artefactos de versión del agente en su bucket de Amazon S3. El siguiente ejemplo de código copia el contenido que `agent_demo` contiene y lo carga en un directorio de su bucket de Amazon S3 llamado `agent_demo`:

   ```
   !aws s3 cp --recursive ./agent_demo s3://{bucket}/agent_demo
   ```

   También necesitas los certificados raíz de firma del bucket de versiones:

   ```
   !aws s3 cp s3://sagemaker-edge-release-store-us-west-2-linux-x64/Certificates/us-west-2/us-west-2.pem ./
   ```

   Cargue el certificado raíz de firma en su bucket de Amazon S3:

   ```
   !aws s3 cp us-west-2.pem s3://{bucket}/authorization-files/
   ```

1. **Defina un archivo de configuración del agente de SageMaker Edge Manager.**

   En primer lugar, defina el archivo de configuración del agente de la siguiente manera:

   ```
   sagemaker_edge_config = {
       "sagemaker_edge_core_device_name": {{"device_name"}},
       "sagemaker_edge_core_device_fleet_name": {{"device_fleet_name"}},
       "sagemaker_edge_core_capture_data_buffer_size": 30,
       "sagemaker_edge_core_capture_data_push_period_seconds": 4,
       "sagemaker_edge_core_folder_prefix": "demo_capture",
       "sagemaker_edge_core_region": "us-west-2",
       "sagemaker_edge_core_root_certs_path": "/agent_demo/certificates",
       "sagemaker_edge_provider_aws_ca_cert_file": "/agent_demo/iot-credentials/AmazonRootCA1.pem",
       "sagemaker_edge_provider_aws_cert_file": "/agent_demo/iot-credentials/device.pem.crt",
       "sagemaker_edge_provider_aws_cert_pk_file": "/agent_demo/iot-credentials/private.pem.key",
       "sagemaker_edge_provider_aws_iot_cred_endpoint": {{"endpoint"}},
       "sagemaker_edge_provider_provider": "Aws",
       "sagemaker_edge_provider_s3_bucket_name": bucket,
       "sagemaker_edge_core_capture_data_destination": "Cloud"
   }
   ```

   Sustituya lo siguiente:
   + `"device_name"` por el nombre de su dispositivo (esta cadena se almacenó en un paso anterior en una variable denominada `device_name`).
   + `"device_fleet_name`“ por el nombre de su flota de dispositivos (esta cadena se almacenó en un paso anterior en una variable denominada `device_fleet_name`)
   + `"endpoint"`con el punto final AWS específico de su cuenta para el proveedor de credenciales (esta cadena se almacenó en un paso anterior en una variable denominada`endpoint`).

   A continuación, guárdela como un archivo JSON:

   ```
   edge_config_file = open("sagemaker_edge_config.json", "w")
   json.dump(sagemaker_edge_config, edge_config_file, indent = 6)
   edge_config_file.close()
   ```

   Cargue el archivo de configuración en su bucket de Amazon S3:

   ```
   !aws s3 cp sagemaker_edge_config.json s3://{bucket}/
   ```

1. **Copie los artefactos de versión, el archivo de configuración y las credenciales en su dispositivo.**

   Las siguientes instrucciones se llevan a cabo en el propio dispositivo periférico.
**nota**  
Primero debe instalar Python AWS SDK para Python (Boto3), el y el AWS CLI en su dispositivo perimetral. 

   Abra un terminal en su dispositivo. Cree una carpeta para almacenar los artefactos de versión, sus credenciales y el archivo de configuración.

   ```
   mkdir agent_demo
   cd agent_demo
   ```

   Copie en su dispositivo el contenido de los artefactos de versión que ha almacenado en su bucket de Amazon S3:

   ```
   # Copy release artifacts 
   aws s3 cp s3://{{<bucket-name>}}/{{agent_demo}}/ ./ --recursive
   ```

   (El contenido del artefacto de versión se almacenó en un directorio llamado `agent_demo` en un paso anterior). Sustituya `<bucket-name>` y `agent_demo` por el nombre del bucket de Amazon S3 y la ruta del archivo a los artefactos de versión, respectivamente.

   Desplácese al directorio `/bin` y haga que los archivos binarios sean ejecutables:

   ```
   cd bin
   
   chmod +x sagemaker_edge_agent_binary
   chmod +x sagemaker_edge_agent_client_example
   
   cd agent_demo
   ```

   Cree un directorio para almacenar sus AWS IoT credenciales y cópielas desde su bucket de Amazon S3 a su dispositivo perimetral (utilice el mismo que defina en la variable`bucket`:

   ```
   mkdir iot-credentials
   cd iot-credentials
   
   aws s3 cp s3://{{<bucket-name>}}/authorization-files/AmazonRootCA1.pem ./
   aws s3 cp s3://{{<bucket-name>}}/authorization-files/device.pem.crt ./
   aws s3 cp s3://{{<bucket-name>}}/authorization-files/private.pem.key ./
   
   cd ../
   ```

   Cree un directorio para almacenar los certificados raíz de firma de su modelo:

   ```
   mkdir certificates
   
   cd certificates
   
   aws s3 cp s3://{{<bucket-name>}}/authorization-files/us-west-2.pem ./
   
   cd agent_demo
   ```

   Copie el archivo de configuración en su dispositivo:

   ```
   #Download config file from S3
   aws s3 cp s3://{{<bucket-name>}}/sagemaker_edge_config.json ./
   
   cd agent_demo
   ```

   El directorio `agent_demo` del dispositivo periférico tendrá un aspecto semejante al siguiente:

   ```
   ├──agent_demo
   |    ├── bin
   |        ├── sagemaker_edge_agent_binary
   |        └── sagemaker_edge_agent_client_example
   |    ├── sagemaker_edge_config.json
   |    ├── certificates
   |        └──us-west-2.pem
   |    ├── iot-credentials
   |        ├── AmazonRootCA1.pem
   |        ├── device.pem.crt
   |        └── private.pem.key
   |    ├── docs
   |        ├── api
   |        └── examples
   |    ├── ATTRIBUTIONS.txt
   |    ├── LICENSE.txt  
   |    └── RELEASE_NOTES.md
   ```