CISCO CSR 1000v usando datos personalizados
Implementación de una máquina virtual Cisco CSR 1000v utilizando datos personalizados
Cuando implementa una instancia de máquina virtual Cisco CSR 1000v en Google Cloud Platform, opcionalmente puede optar por utilizar la sección Script de inicio en la consola de creación de VM para proporcionar datos personalizados. También puede utilizar la CLI para acceder a los datos personalizados y lograr diversos objetivos de automatización. Los datos personalizados en GCP le permiten ejecutar comandos de configuración de Cisco IOS XE, instalar paquetes Python en guestshell el día 0, ejecutar scripts en guestshell el día 0 y proporcionar información de licencia para iniciar la instancia CSR 1000v con el paquete de tecnología deseado.
Versiones admitidas
Puede implementar una máquina virtual Cisco CSR 1000v utilizando datos personalizados solo en Cisco IOS XE Gibraltar 16.12.1 o versiones posteriores.
- Editar los datos personalizados,
- Accediendo a los datos personalizados,
- Verificación de la configuración de datos personalizados,
Editar los datos personalizados
Para editar los datos personalizados, configure las siguientes propiedades:
- configuración IOS
- Guiones
- Credenciales de guión
- Paquete Python
- Licencias
Puedes colocar las propiedades en un file en cualquier orden. Las siguientes descripciones de propiedades especifican las dependencias entre las propiedades, si las hay. ver el exampel arranque filese sentó: https://github.com/csr1000v/customdata-examples.
Después de definir las propiedades de los datos personalizados, puede acceder al script de inicio o a los datos personalizados. file utilizando la CLI como se describe en la sección Acceso a datos personalizados.
Configuración de la propiedad de configuración de IOS
Si desea iniciar la configuración de IOS el día 0, configure la propiedad Configuración de IOS. Vea la siguiente configuración de IOS exampen:
- Sección: Configuración de IOS
- nombre de host CSR1
- interfaz GigabitEthernet1
- descripción "configuración de dirección IP estática"
- Dirección IP 10.0.0.1 255.255.255.0
- interfaz GigabitEthernet2
- descripción “Configuración de dirección IP basada en DHCP”
- dirección IPDHCP
Después de la primera línea que dice Sección: Configuración de IOS, puede ingresar una lista de comandos de configuración de Cisco IOS XE que desea ejecutar en el enrutador Cisco CSR 1000v.
Cuando ejecuta este comando, la configuración de IOS anterior se aplica al enrutador CSR 1000v que se ejecuta en GCP, el día 0.
Configurar la propiedad de secuencias de comandos
La propiedad Scripts le ayuda a automatizar la implementación de su instancia CSR1000v. Si desea ejecutar un script Python o Bash en el día 0 en el contexto del guestshell, proporcione el archivo público URL y argumentos del script python o bash en la propiedad Scripts. Un script debe incluir un fragmento de código que incluya el carácter shebang (!) en la primera línea del script. Esta línea le indica a Cisco IOS-XE qué intérprete de script (Python o Bash) debe utilizar para analizar el código del script. por ejemploamparchivo, la primera línea de un script de Python puede contener #!/usr/bin/env python, mientras que la primera línea de un script de Bash puede contener #!/bin/bash. Esta línea permite que el script Python o Bash se ejecute como código ejecutable en un entorno Linux. Cuando ejecuta el script, éste se ejecuta en el contenedor guestshell de la instancia Cisco CSR 1000v. Para acceder al contenedor de guestshell, utilice el comando del modo EXEC de guestshell. Para obtener más información sobre el comando guestshell, consulte la Guía de configuración de programabilidad. Para configurar la propiedad Scripts, utilice el siguiente formato:
Sección: guiones
público_url
En este script, la primera línea de la propiedad debe leer Sección: Scripts. En la segunda línea de la propiedad, ingrese el URL del guión y los argumentos del guión. El script puede ser un script Python o Bash. El script se ejecuta en guestshell en el primer arranque cuando carga los datos personalizados. file, cuando crea la instancia CSR1000v. A view más examparchivos de los scripts, consulte “scripts” en: https://github.com/csr1000v/customdata-examples. Además, consulte el siguiente ejemplo.ampellos:
Exampel 1
Sección: Guión
https://raw.githubusercontent.com/csr1000v/customdata-examples/master/scripts/smartLicensingConfigurator.py–idtoken”<token_string>”–throughput The two lines in the scripts property retrieve the smartLicensingConfigurator.py script from the custom data-examples repository at the specified URL. The script runs in the guestshell container of the Cisco CSR 1000v with the arguments idtoken and throughput.
Exampel 2
Sección: Guiones
ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2
Estas dos líneas en la propiedad Scripts recuperan el script.pyscript del servidor FTP con la dirección IP 10.11.0.4 y ejecutan el script con el comando Bash ./script.py -a arg1 -s arg2 en el contenedor guestshell de Cisco. Instancia CSR 1000v usando los argumentos arg1 y arg2.
Nota Si un script en la propiedad Scripts requiere un paquete de Python que no está incluido en la versión estándar de CentOS Linux (la versión de CentOS Linux que utiliza actualmente el guestshell es CentOS Linux versión 7.1.1503), debe incluir información sobre el paquete de Python. en la propiedad del paquete Python. Para obtener más información, consulte: Configuración de la propiedad del paquete Python. Antes de acceder a los datos personalizados y ejecutar el script Bash o Python, Cisco recomienda que pruebe el
URL que desea utilizar, utilizando la propiedad Scripts. Puede probar ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2 ejecutando primero el comando curl herramienta de software para descargar el script file. En el shell de invitados, ingrese la curl comando como se muestra en el siguiente ejemploample:curl -m 30 –reintentar 5 –usuario nombre de usuario:contraseña ftp://10.11.0.4/dir1/dir2/script_needs_credentials.py. si la curl El comando tiene éxito, se descarga una copia del script Python, que verifica si el URL Es correcto.
Configuración de la propiedad de credenciales de secuencia de comandos
Si ha especificado un servidor FTP en la propiedad Script y el servidor requiere credenciales de nombre de usuario y contraseña, especifique las credenciales mediante la propiedad Credenciales de Script.
Nota Si puede acceder al servidor FTP de forma anónima, no necesita utilizar la propiedad Credenciales del script. Configure la propiedad Scripts con un URL y parámetros que coincidan con los de la propiedad Credenciales del script. Para configurar la propiedad Credenciales de script, utilice el siguiente formato: Sección: Credenciales de script public_url
Example
Sección: Credenciales de script
ftp://10.11.0.4/dir1/dir2/script1.py userfoo foospass La segunda línea en la propiedad Credenciales del script especifica los valores de las credenciales de nombre de usuario (userfoo) y contraseña (foospass) para el script de Python script1.py. Incluya el nombre del servidor FTP que también se encuentra en la propiedad Scripts. un exampLa línea de la propiedad Scripts es: ftp://10.11.0.4/dir1/dir2/script1.py -a arg1 -s arg2. ver example 2 en Configuración de la propiedad de scripts,
Configurar la propiedad del paquete Python
Si un script requiere un paquete de Python en la propiedad Scripts y no forma parte de la versión 7.1.1503 estándar de CentOS Linux, debe incluir información sobre el paquete en la propiedad del paquete de Python. Incluyendo la propiedad del paquete Python en el bootstrap file, se asegura de que Cisco CSR 1000v descargue e instale el paquete Python requerido antes de que los datos personalizados file que especificó en la propiedad Scripts.
Configurar la propiedad del paquete Python
Para configurar la propiedad del paquete Python, utilice el siguiente formato:
Sección: Paquete Python
nombre_paquete [ versión ] [ sudo ] { [ pip_arg1 [ ..[ pip_arg9] ] ] } Los argumentos: versión, sudo y pip_arg1 a pip_arg9 son opcionales. Debes poner los argumentos del comando pip entre llaves “{“ y “}”. Si especifica el argumento de versión, se descarga un número de versión específico. Si especifica el argumento sudo, el paquete se descarga como usuario sudo. Configuración ejemploampLos
Exampel 1
Sección: Paquete Python
cliente 0.5.2
En este examparchivo, la segunda línea de la propiedad del paquete Python especifica que el nombre del paquete es "ncclient" y la versión es "0.5.2". Cuando el arranque file Cuando se carga, la versión 0.5.2 del paquete ncclient se instala en el contenedor guestshell de Cisco CSR 1000v.
Exampel 2
Sección: Paquete Python
csr_gcp_ha 3.0.0 sudo {–user} En este ejemploamparchivo, la segunda línea de la propiedad del paquete Python especifica que el nombre del paquete es "csr_gcp_ha" y la versión es "3.0.0". Cuando el arranque file Cuando se carga, la versión 3.0.0 del paquete csr_gcp_ha se instala en el contenedor guestshell de Cisco CSR 1000v. El siguiente comando se ejecuta como usuario sudo: pip install csr_gcp_ha=3.0.0 –user.
Configurar la propiedad Licencia
Configure la propiedad de licencia para especificar el nivel de tecnología de licencia para la instancia Cisco CSR 1000v.
- Ingrese la primera línea de la propiedad en el formato: Sección: Licencia.
- Ingrese la segunda línea de la propiedad, que especifica el nivel tecnológico de la licencia, usando el siguiente formato: TechPackage:tech_level.
Nota Asegúrese de que no haya espacios entre "TechPackage:" y tech_level. Los posibles valores tech_level incluyen: ax, seguridad, appx o ipbase.
Asegúrese de que tech_level esté en minúsculas.
Configuración Example
Sección: Licencia TechPackage:seguridad
Accediendo a los datos personalizados
- Para ejecutar los datos personalizados como file utilizando la CLI, ejecute el siguiente script: Acceso a los datos personalizados file usando la CLI
- Para ejecutar los datos personalizados como file mediante la CLI, ejecute el siguiente script: crear instancias informáticas de gcloud –metadatos-de-file=script-inicio=datos personalizados.txt –imagen
- Cuando ejecuta este comando, se crea una máquina virtual Cisco CSR 1000v. El enrutador se configura usando los comandos en el file: “Datos personalizados.txt”.
Acceder a los datos personalizados desde la consola Para acceder a los datos personalizados desde la consola, inicie sesión en la consola de GCP. Haga clic en Compute Engine y seleccione Crear una instancia. En la pantalla Nueva instancia de VM, haga clic en Administración > Script de inicio.
Verificación de la configuración de datos personalizados
Después de ejecutar el script de datos personalizado, se crea la VM y se ejecutan los comandos de configuración. Para verificar lo mismo, utilice los siguientes comandos y scripts:
- show version: Para ayudar a determinar si la propiedad de la licencia funcionó, en Cisco IOS XE CLI en el CSR 1000v, ingrese el comando show version. por ejemploamparchivo, la salida muestra una referencia a la licencia de seguridad.
- Para ver si se produjeron errores después de ejecutar comandos en la propiedad de scripts, consulte customdata.log file en el /bootflash/ /directorio. El scriptname.log file almacena cualquier salida que el script envíe a STDOUT.
- Para verificar si la propiedad de Python funcionó, ingrese el pip congelar | grep comando desde el Guestshell para view los paquetes de Python actualmente instalados. Aquí, nombre-paquete se refiere al paquete que está buscando específicamente.
- Para verificar los comandos de Cisco IOS XE en la propiedad Configuración de IOS, ejecute el comando show running-configuration.
Documentos / Recursos
 |
CISCO CSR 1000v usando datos personalizados [pdf] Manual del usuario CSR 1000v usando datos personalizados, CSR 1000v, usando datos personalizados, datos personalizados, datos |