CISCO-логотип

CISCO CSR 1000v з використанням спеціальних даних

Продукт CISCO-CSR-1000v-Using-Custom-Data

Розгортання віртуальної машини Cisco CSR 1000v з використанням спеціальних даних

Коли ви розгортаєте екземпляр віртуальної машини Cisco CSR 1000v на Google Cloud Platform, ви можете вибрати використання розділу Startup Script на консолі створення віртуальної машини, щоб надати спеціальні дані. Ви також можете використовувати CLI для доступу до спеціальних даних для досягнення різних цілей автоматизації. Користувальницькі дані в GCP дозволяють запускати команди конфігурації Cisco IOS XE, інсталювати пакети Python у Guestshell на Day0, запускати сценарії в Guestshell на Day0 і надавати інформацію про ліцензування для завантаження екземпляра CSR 1000v із потрібним технологічним пакетом.

Релізи підтримуються
Ви можете розгорнути віртуальну машину Cisco CSR 1000v, використовуючи спеціальні дані, лише на Cisco IOS XE Gibraltar 16.12.1 або пізнішої версії.

  • Редагування спеціальних даних,
  • Доступ до спеціальних даних,
  • Перевірка конфігурації спеціальних даних,

Редагування спеціальних даних

Щоб редагувати спеціальні дані, налаштуйте такі властивості:

  • Конфігурація IOS
  • Сценарії
  • Облікові дані сценарію
  • Пакет Python
  • Ліцензування

Ви можете розмістити властивості в a file в довільному порядку. Наступні описи властивостей визначають залежності між властивостями, якщо такі є. Дивіться ексample bootstrap files в: https://github.com/csr1000v/customdata-examples.

Після визначення властивостей настроюваних даних ви можете отримати доступ до сценарію запуску або настроюваних даних file за допомогою CLI, як описано в розділі Доступ до спеціальних даних.

Налаштування властивості конфігурації IOS

Якщо ви хочете завантажувати конфігурацію IOS у день 0, налаштуйте властивість IOS Configuration. Перегляньте наступну конфігурацію IOS, напрampле:

  • Розділ: Конфігурація IOS
  • ім'я хоста CSR1
  • інтерфейс GigabitEthernet1
  • опис «конфігурація статичної IP-адреси»
  • IP-адреса 10.0.0.1 255.255.255.0
  • інтерфейс GigabitEthernet2
  • опис «Конфігурація IP-адреси на основі DHCP»
  • ip адреса dhcp

Після першого рядка, який читає Розділ: Конфігурація IOS, ви можете ввести список команд конфігурації Cisco IOS XE, які ви хочете виконати на маршрутизаторі Cisco CSR 1000v.
Коли ви виконуєте цю команду, попередня конфігурація IOS застосовується до маршрутизатора CSR 1000v, що працює на GCP, у день 0.

Налаштування властивості сценаріїв

Властивість Scripts допомагає автоматизувати розгортання екземпляра CSR1000v. Якщо ви хочете запустити сценарій Python або Bash на Day0 у контексті Guestshell, надайте public URL і аргументи сценарію python або bash у властивості Scripts. Сценарій повинен містити фрагмент коду, який містить символ shebang (!) у першому рядку сценарію. Цей рядок повідомляє Cisco IOS-XE, який інтерпретатор сценаріїв (Python або Bash) потрібно використовувати для аналізу коду сценарію. наприкладample, перший рядок сценарію Python може містити #!/usr/bin/env python, тоді як перший рядок сценарію Bash може містити #!/bin/bash. Цей рядок дозволяє виконувати сценарій Python або Bash як виконуваний код у середовищі Linux. Коли ви виконуєте сценарій, він запускається в контейнері Guestshell екземпляра Cisco CSR 1000v. Щоб отримати доступ до контейнера Guestshell, скористайтеся командою режиму EXEC. Додаткову інформацію про команду guesthell див. у Посібнику з конфігурації програмування. Щоб налаштувати властивість сценаріїв, використовуйте такий формат:
Розділ: скрипти
public_url
У цьому сценарії перший рядок властивості має бути Розділ: Скрипти. У другому рядку властивості введіть URL сценарію та аргументів сценарію. Сценарій може бути сценарієм Python або Bash. Сценарій запускається в Guestshell під час першого завантаження, коли ви завантажуєте спеціальні дані file, коли ви створюєте примірник CSR1000v. до view більше ексampфайли сценаріїв див. «сценарії» за адресою: https://github.com/csr1000v/customdata-examples. Також зверніться до наступного прикладуamples:
Example 1
Розділ: Сценарій
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.

Example 2
Розділ: Скрипти
ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2
Ці два рядки у властивості Scripts отримують script.pyscript із FTP-сервера з IP-адресою 10.11.0.4 і запускають сценарій за допомогою команди ./script.py -a arg1 -s arg2 Bash у контейнері guestshell Cisco. Екземпляр CSR 1000v використовує аргументи arg1 і arg2.

Примітка Якщо для сценарію у властивості Scripts потрібен пакет Python, який не входить до стандартного випуску CentOS Linux (випуск CentOS Linux, який наразі використовується гостьовою оболонкою, є випуском CentOS Linux 7.1.1503), ви повинні включити інформацію про пакет Python у властивості пакета Python. Щоб отримати додаткові відомості, див.: Налаштування властивості пакета Python. Перед тим, як отримати доступ до спеціальних даних і запустити сценарій Bash або Python, Cisco рекомендує перевірити
URL який ви збираєтеся використовувати, використовуючи властивість Scripts. Ви можете перевірити ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2, спочатку запустивши curl програмне забезпечення для завантаження сценарію file. У гостьовій оболонці введіть curl команду, як показано в наступному прикладіample: curl -m 30 – повторна спроба 5 – ім’я користувача: пароль ftp://10.11.0.4/dir1/dir2/script_needs_credentials.py. Якщо curl команда виконана успішно, завантажується копія сценарію Python, яка перевіряє, чи є URL є правильним.

Налаштування властивості облікових даних сценарію

Якщо ви вказали FTP-сервер у властивості Script, і сервер вимагає облікових даних імені користувача та пароля, укажіть облікові дані за допомогою властивості Script credentials.

Примітка Якщо ви можете отримати доступ до FTP-сервера анонімно, вам не потрібно використовувати властивість облікових даних сценарію. Налаштуйте властивість Scripts за допомогою a URL і параметри, які відповідають властивостям облікових даних сценарію. Щоб налаштувати властивість облікових даних сценарію, використовуйте такий формат: Розділ: облікові дані сценарію public_url
Example
Розділ: Облікові дані сценарію
ftp://10.11.0.4/dir1/dir2/script1.py userfoo foospass Другий рядок у властивості Script credentials визначає значення облікових даних імені користувача (userfoo) і пароля (foospass) для сценарію python script1.py. Включіть назву FTP-сервера, який також є у властивості Scripts. колишнійampу властивості Scripts: ftp://10.11.0.4/dir1/dir2/script1.py -a arg1 -s arg2. див. прample 2 у розділі Налаштування властивості сценаріїв,

Налаштування властивості пакета Python

Якщо пакет Python вимагається сценарієм у властивості Scripts і він не є частиною стандартного випуску CentOS Linux 7.1.1503, ви повинні включити інформацію про пакет у властивість пакета Python. Додавши властивість пакета Python до початкового завантаження file, ви переконаєтеся, що Cisco CSR 1000v завантажує та інсталює необхідний пакет Python перед користувацькими даними file який ви вказали у властивості Scripts.
Налаштувати властивість пакета Python
Щоб налаштувати властивість пакета Python, використовуйте такий формат:
Розділ: Пакет Python
package_name [ версія ] [ sudo ] { [ pip_arg1 [ ..[ pip_arg9] ] ] } Аргументи: версія, sudo та pip_arg1 до pip_arg9 необов’язкові. Ви повинні розмістити аргументи команди pip між дужками «{» і «}». Якщо вказати аргумент версії, буде завантажено певний номер версії. Якщо вказати аргумент sudo, пакет завантажується як користувач sudo. Конфігурація Прampлес
Example 1
Розділ: Пакет Python
ncclient 0.5.2
У цьому ексample, другий рядок властивості пакета Python визначає, що ім’я_пакета — «ncclient», а версія — «0.5.2». При завантаженні file завантажується, версія 0.5.2 пакета ncclient встановлена ​​в контейнері guestshell Cisco CSR 1000v.
Example 2
Розділ: Пакет Python
csr_gcp_ha 3.0.0 sudo {–user} У цьому прикладіample, другий рядок властивості пакета Python вказує, що назва_пакета — «csr_gcp_ha», а версія — «3.0.0». При початковому завантаженні file завантажується, версія 3.0.0 пакета csr_gcp_ha встановлена ​​в контейнері guestshell Cisco CSR 1000v. Наступна команда виконується як користувач sudo: pip install csr_gcp_ha=3.0.0 –user.

Налаштування властивості Ліцензія

Налаштуйте властивість ліцензії, щоб указати рівень технології ліцензії для примірника Cisco CSR 1000v.

  • Введіть перший рядок властивості у форматі: Розділ: Ліцензія.
  • Введіть другий рядок властивості, який визначає технічний рівень ліцензії, використовуючи такий формат: TechPackage:tech_level .

Примітка  Переконайтеся, що між «TechPackage:» і tech_level немає пробілів. Можливі значення tech_level включають: axe, security, appx або ipbase.
Переконайтеся, що tech_level написано малими літерами.

Конфігурація Прample
Розділ: Ліцензія TechPackage:безпека

Доступ до користувацьких даних

  • Щоб запустити спеціальні дані як a file за допомогою CLI виконайте такий сценарій: Доступ до настроюваних даних file за допомогою CLI
  • Щоб запустити спеціальні дані як a file за допомогою CLI виконайте такий сценарій: gcloud compute instances create –metadata-from-file=startup-script=Customdata.txt –image
  • Коли ви виконуєте цю команду, створюється віртуальна машина Cisco CSR 1000v. Маршрутизатор налаштовується за допомогою команд у file: «Customdata.txt».
    Доступ до спеціальних даних із консолі Щоб отримати доступ до спеціальних даних із консолі, увійдіть у консоль GCP. Натисніть Compute Engine і виберіть Створити екземпляр. На екрані «Новий екземпляр віртуальної машини» натисніть «Керування» > «Сценарій запуску».

CISCO-CSR-1000v-Using-Custom-Data-fig-1

Перевірка конфігурації спеціальних даних

Після запуску сценарію настроюваних даних створюється віртуальна машина та виконуються команди конфігурації. Щоб перевірити те саме, використовуйте такі команди та сценарії:

  • show version: щоб визначити, чи спрацювала властивість ліцензії, у Cisco IOS XE CLI на CSR 1000v введіть команду show version. наприкладample, результат відображає посилання на ліцензію безпеки.
  • Щоб перевірити, чи виникли помилки після виконання команд у властивості сценаріїв, подивіться на customdata.log file у каталозі /bootflash//. scriptname.log file зберігає будь-який вихід, який сценарій надсилає до STDOUT.
  • Щоб перевірити, чи працювала властивість Python, введіть pip freeze | grep команда з гостьової оболонки to view поточні встановлені пакети Python. Тут ім'я пакета стосується пакета, який ви шукаєте.
  • Щоб перевірити команди Cisco IOS XE у властивості IOS Configuration, виконайте команду show running-configuration.

Документи / Ресурси

CISCO CSR 1000v з використанням спеціальних даних [pdfПосібник користувача
CSR 1000v з використанням користувацьких даних, CSR 1000v, використання користувацьких даних, користувацькі дані, дані

Список літератури

Залиште коментар

Ваша електронна адреса не буде опублікована. Обов'язкові поля позначені *