CISCO CSR 1000v använder anpassade data
Distribuera en Cisco CSR 1000v virtuell dator med hjälp av anpassade data
När du distribuerar en Cisco CSR 1000v Virtual Machine-instans på Google Cloud Platform kan du välja att använda avsnittet Startup Script på konsolen för att skapa virtuella datorer för att tillhandahålla anpassade data. Du kan också använda CLI för att komma åt anpassade data för att uppnå olika automatiseringsmål. De anpassade data i GCP låter dig köra Cisco IOS XE-konfigurationskommandon, installera Python-paket i guesthell på Day0, köra skript i guesthell på Day0 och tillhandahålla licensinformation för att starta CSR 1000v-instansen med ett önskat teknikpaket.
Utgåvor som stöds
Du kan distribuera en Cisco CSR 1000v virtuell dator med anpassad data endast på Cisco IOS XE Gibraltar 16.12.1 eller senare versioner.
- Redigera anpassade data,
- Åtkomst till anpassade data,
- Verifiera den anpassade datakonfigurationen,
Redigera anpassade data
För att redigera anpassade data, konfigurera följande egenskaper:
- IOS-konfiguration
- Manus
- Manusuppgifter
- Python-paket
- Licensiering
Du kan placera fastigheterna i en file i vilken ordning som helst. Följande egenskapsbeskrivningar anger beroenden mellan egenskaperna, om några. Se example bootstrap files på: https://github.com/csr1000v/customdata-examples.
Efter att ha definierat de anpassade dataegenskaperna kan du komma åt startskriptet eller anpassade data file använda CLI enligt beskrivningen i avsnittet Åtkomst till anpassade data.
Konfigurera IOS Configuration Property
Om du vill starta upp IOS-konfigurationen på Dag0, konfigurera egenskapen IOS Configuration. Se följande IOS-konfiguration exampde:
- Avsnitt: IOS-konfiguration
- värdnamn CSR1
- gränssnitt GigabitEthernet1
- beskrivning "statisk IP-adresskonfiguration"
- IP-adress 10.0.0.1 255.255.255.0
- gränssnitt GigabitEthernet2
- beskrivning "DHCP-baserad IP-adresskonfiguration"
- ip-adress dhcp
Efter den första raden som lyder avsnitt: IOS-konfiguration kan du ange en lista över Cisco IOS XE-konfigurationskommandon som du vill utföra, på Cisco CSR 1000v-routern.
När du kör det här kommandot tillämpas föregående IOS-konfiguration på CSR 1000v-routern som körs på GCP, dag 0.
Konfigurera skriptegenskapen
Scripts-egenskapen hjälper dig att automatisera distributionen av din CSR1000v-instans. Om du vill köra ett Python- eller ett Bash-skript på Day0 under guesthell-kontexten, tillhandahåll allmänheten URL och argument för python eller bash-skriptet i Scripts-egenskapen. Ett skript måste innehålla en bit kod som innehåller tecknet shebang (!) i skriptets första rad. Den här raden talar om för Cisco IOS-XE vilken skripttolkare (Python eller Bash) du måste använda för att analysera skriptkoden. Till exempelample, den första raden i ett Python-skript kan innehålla #!/usr/bin/env python, medan den första raden i ett Bash-skript kan innehålla #!/bin/bash. Denna rad låter Python- eller Bash-skriptet köras som körbar kod i en Linux-miljö. När du kör skriptet körs skriptet i gästskalsbehållaren för Cisco CSR 1000v-instansen. För att komma åt guesthell-behållaren, använd EXEC mode-kommandot för guesthell. För mer information om guesthell-kommandot, se Programmerbarhetskonfigurationsguiden. För att konfigurera Script-egenskapen, använd följande format:
Avsnitt: manus
offentlig_url
I det här skriptet bör den första raden i egenskapen läsa Avsnitt: Skript. På den andra raden i fastigheten anger du URL av manuset och manusets argument. Skriptet kan vara antingen ett Python- eller ett Bash-skript. Skriptet körs i guesthell i den första uppstarten när du laddar upp anpassad data file, när du skapar CSR1000v-instansen. Till view mer examples av skripten, se "skript" på: https://github.com/csr1000v/customdata-examples. Se även följande examples:
Example 1
Avsnitt: Manus
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
Avsnitt: Manus
ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2
Dessa två rader i Script-egenskapen hämtar script.pyscript från FTP-servern med IP-adressen 10.11.0.4 och kör skriptet med kommandot ./script.py -a arg1 -s arg2 Bash i gästskalsbehållaren i Cisco CSR 1000v-instans som använder argumenten arg1 och arg2.
Notera Om ett skript i egenskapen Scripts kräver ett Python-paket som inte ingår i standardversionen av CentOS Linux (den CentOS Linux-version som för närvarande används av gästskalet är CentOS Linux-version 7.1.1503), måste du inkludera information om Python-paketet i Python-paketegenskapen. För mer information, se: Konfigurera Python-paketets egenskap, Innan du kommer åt anpassade data och kör Bash- eller Python-skriptet rekommenderar Cisco att du testar
URL som du tänker använda med Scripts-egenskapen. Du kan testa ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2 genom att först köra c:turl programvara för att ladda ner skriptet file. I gästskalet, skriv in curl kommando som visas i följande example: curl -m 30 –försök igen 5 –användare användarnamn:lösenord ftp://10.11.0.4/dir1/dir2/script_needs_credentials.py. Om curl kommandot lyckas, laddas en kopia av Python-skriptet ned, som verifierar om URL är korrekt.
Konfigurera egenskapen Script Credentials
Om du har angett en FTP-server i Script-egenskapen och servern kräver ett användarnamn och lösenord, anger du autentiseringsuppgifterna med Script credentials-egenskapen.
Notera Om du kan komma åt FTP-servern anonymt, behöver du inte använda egenskapen Script credentials. Konfigurera egenskapen Scripts med en URL och parametrar som matchar de i egenskapen Script credentials. För att konfigurera egenskapen Script credentials, använd följande format: Avsnitt: Script credentials public_url
Example
Avsnitt: Skriptuppgifter
ftp://10.11.0.4/dir1/dir2/script1.py userfoo foospass Den andra raden i Script credentials-egenskapen anger värdena för användarnamnet (userfoo) och lösenordet (foospass) för python-skriptet script1.py. Inkludera namnet på FTP-servern som också finns i Scripts-egenskapen. Ett exampraden i Script-egenskapen är: ftp://10.11.0.4/dir1/dir2/script1.py -a arg1 -s arg2. Se exampavsnitt 2 i Konfigurera skriptegenskapen,
Konfigurera Python-paketets egenskap
Om ett Python-paket krävs av ett skript i Script-egenskapen och det inte är en del av standard CentOS Linux-version 7.1.1503, måste du inkludera information om paketet i Python-paketegenskapen. Genom att inkludera Python-paketegenskapen i bootstrap file, ser du till att Cisco CSR 1000v laddar ner och installerar det nödvändiga Python-paketet före anpassade data file som du angav i egenskapen Scripts.
Konfigurera Python Package Property
För att konfigurera Python-paketegenskapen, använd följande format:
Avsnitt: Python-paket
paketnamn [ version ] [ sudo ] { [ pip_arg1 [ ..[ pip_arg9] ] ] } Argumenten: version, sudo och pip_arg1 till pip_arg9 är valfria. Du måste lägga argumenten till pip-kommandot mellan "{" och "}" klammerparenteser. Om du anger versionsargumentet laddas ett specifikt versionsnummer ned. Om du anger sudo-argumentet laddas paketet ned som en sudo-användare. Konfiguration Examples
Example 1
Avsnitt: Python-paket
nclient 0.5.2
I detta example, den andra raden i Python-paketegenskapen anger att paketnamnet är "ncclient" och versionen är "0.5.2". När bootstrap file laddas upp, installeras version 0.5.2 av ncclient-paketet i gästskalsbehållaren på Cisco CSR 1000v.
Example 2
Avsnitt: Python-paket
csr_gcp_ha 3.0.0 sudo {–user} I detta example, den andra raden i Python-paketegenskapen anger att paketnamnet är "csr_gcp_ha" och versionen är "3.0.0". När bootstrap file laddas upp, installeras version 3.0.0 av csr_gcp_ha-paketet i gästskalsbehållaren på Cisco CSR 1000v. Följande kommando körs som sudo-användare: pip install csr_gcp_ha=3.0.0 –användare.
Konfigurera egendomen License
Konfigurera licensegenskapen för att ange licenstekniknivån för Cisco CSR 1000v-instansen.
- Ange den första raden i egenskapen i formatet: Avsnitt: Licens.
- Ange den andra raden i egenskapen, som anger licensens tekniska nivå, med följande format: TechPackage:tech_level .
Notera Se till att det inte finns några mellanslag mellan "TechPackage:" och tech_level. De möjliga tech_level-värdena inkluderar: axe, security, appx eller ipbase.
Se till att tech_level är med gemener.
Konfiguration Example
Avsnitt: Licens TechPackage:säkerhet
Åtkomst till anpassade data
- För att köra anpassade data som en file genom att använda CLI, exekvera följande skript: Åtkomst till anpassade data file med hjälp av CLI
- För att köra anpassade data som en file genom att använda CLI, kör följande skript: gcloud compute-instanser skapa –metadata-från-file=startup-script=Customdata.txt –bild
- När du kör det här kommandot skapas en Cisco CSR 1000v VM. Routern konfigureras med hjälp av kommandona i file: "Customdata.txt".
Åtkomst till anpassade data från konsolen För att komma åt anpassade data från konsolen, logga in på GCP-konsolen. Klicka på Compute Engine och välj Skapa en instans. På skärmen Ny VM-instans klickar du på Hantering > Startskript.
Verifiera den anpassade datakonfigurationen
När du har kört det anpassade dataskriptet skapas den virtuella datorn och konfigurationskommandona körs. För att verifiera detsamma, använd följande kommandon och skript:
- visa version: För att avgöra om licensegenskapen fungerade, anger du kommandot show version i Cisco IOS XE CLI på CSR 1000v. Till exempelample, utdata visar en referens till säkerhetslicensen.
- För att se om fel uppstod efter att ha kört kommandon i script-egenskapen, titta på customdata.log file i /bootflash/ /katalog. scriptname.log file lagrar alla utdata som skickas till STDOUT av skriptet.
- För att verifiera om Python-egenskapen fungerade, ange pip freeze | grep kommandot från gästskalet till view de för närvarande installerade Python-paketen. Här hänvisar paketnamn till paketet som du specifikt söker efter.
- För att verifiera Cisco IOS XE-kommandona i egenskapen IOS Configuration, kör kommandot show running-configuration.
Dokument/resurser
 |
CISCO CSR 1000v använder anpassade data [pdf] Användarmanual CSR 1000v använder anpassade data, CSR 1000v, använder anpassade data, anpassade data, data |