CISCO CSR 1000v Aangepaste gegevens gebruiken
Een Cisco CSR 1000v VM implementeren met behulp van aangepaste gegevens
Wanneer u een Cisco CSR 1000v Virtual Machine-instantie op Google Cloud Platform implementeert, kunt u er optioneel voor kiezen om de sectie Opstartscript op de console voor het maken van VM's te gebruiken om aangepaste gegevens aan te leveren. U kunt de CLI ook gebruiken om toegang te krijgen tot de aangepaste gegevens om verschillende automatiseringsdoelen te bereiken. Met de aangepaste gegevens in GCP kunt u Cisco IOS XE-configuratieopdrachten uitvoeren, Python-pakketten in guestshell op Dag 0 installeren, scripts in guestshell op Dag 0 uitvoeren en licentie-informatie verstrekken om de CSR 1000v-instantie op te starten met een gewenst technologiepakket.
Releases ondersteund
U kunt een Cisco CSR 1000v-VM alleen implementeren met behulp van aangepaste gegevens op Cisco IOS XE Gibraltar 16.12.1 of latere releases.
- De aangepaste gegevens bewerken,
- Toegang tot de aangepaste gegevens,
- De aangepaste gegevensconfiguratie verifiëren,
De aangepaste gegevens bewerken
Om de aangepaste gegevens te bewerken, configureert u de volgende eigenschappen:
- IOS-configuratie
- Scripts
- Scriptreferenties
- Python-pakket
- Licentieverlening
U kunt de eigenschappen in a plaatsen file in elke volgorde. In de volgende eigenschapsbeschrijvingen worden eventuele afhankelijkheden tussen de eigenschappen gespecificeerd. Zie de exampde bootstrap fileza: https://github.com/csr1000v/customdata-examples.
Nadat u de aangepaste gegevenseigenschappen hebt gedefinieerd, heeft u toegang tot het opstartscript of de aangepaste gegevens file met behulp van de CLI zoals beschreven in de sectie Toegang tot de aangepaste gegevens.
De IOS-configuratie-eigenschap configureren
Als u de IOS-configuratie op Dag 0 wilt opstarten, configureert u de IOS-configuratie-eigenschap. Zie de volgende IOS-configuratie, bijvampon:
- Sectie: IOS-configuratie
- hostnaam CSR1
- interface GigabitEthernet1
- beschrijving “statische IP-adresconfiguratie”
- IP-adres 10.0.0.1 255.255.255.0
- interface GigabitEthernet2
- beschrijving “DHCP-gebaseerde IP-adresconfiguratie”
- ip adres dhcp
Na de eerste regel met de tekst Section: IOS-configuratie, kunt u een lijst met Cisco IOS XE-configuratieopdrachten invoeren die u wilt uitvoeren op de Cisco CSR 1000v-router.
Wanneer u deze opdracht uitvoert, wordt de voorgaande IOS-configuratie op dag 1000 toegepast op de CSR 0v-router die op GCP draait.
De eigenschap Scripts configureren
Met de eigenschap Scripts kunt u de implementatie van uw CSR1000v-instantie automatiseren. Als je op Dag 0 een Python- of een Bash-script wilt uitvoeren onder de gastshell-context, geef dan het public URL en argumenten van het Python- of het bash-script in de eigenschap Scripts. Een script moet een stukje code bevatten waarin het shebang-teken (!) op de eerste regel van het script staat. Deze regel vertelt Cisco IOS-XE welke scriptinterpreter (Python of Bash) u moet gebruiken om de scriptcode te parseren. Bijvoorbeeldample kan de eerste regel van een Python-script #!/usr/bin/env python bevatten, terwijl de eerste regel van een Bash-script #!/bin/bash kan bevatten. Met deze regel kan het Python- of het Bash-script als uitvoerbare code in een Linux-omgeving worden uitgevoerd. Wanneer u het script uitvoert, wordt het script uitgevoerd in de guestshell-container van de Cisco CSR 1000v-instantie. Om toegang te krijgen tot de guestshell-container, gebruikt u de guestshell EXEC-modusopdracht. Zie de Programmeerbaarheidsconfiguratiehandleiding voor meer informatie over de guestshell-opdracht. Gebruik de volgende indeling om de eigenschap Scripts te configureren:
Sectie: scripts
publiek_url
In dit script moet op de eerste regel van de eigenschap Section: Scripts staan. Voer op de tweede regel van de eigenschap de URL van het script en de argumenten van het script. Het script kan een Python- of een Bash-script zijn. Het script wordt tijdens de eerste keer opstarten in de gastshell uitgevoerd wanneer u de aangepaste gegevens uploadt file, wanneer u de CSR1000v-instantie maakt. Naar view meer bijvampbestanden van de scripts, zie “scripts” op: https://github.com/csr1000v/customdata-examples. Zie ook het volgende voorbeeldamples:
Exampde 1
Sectie: Script
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.
Exampde 2
Sectie: Scripts
ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2
Deze twee regels in de eigenschap Scripts halen script.pyscript op van de FTP-server met het IP-adres 10.11.0.4 en voeren het script uit met de opdracht ./script.py -a arg1 -s arg2 Bash in de guestshell-container van de Cisco CSR 1000v-instantie met de argumenten arg1 en arg2.
Opmerking Als een script in de eigenschap Scripts een Python-pakket vereist dat niet is opgenomen in de standaard CentOS Linux-release (de CentOS Linux-release die momenteel door de gastshell wordt gebruikt is CentOS Linux release 7.1.1503), moet u informatie over het Python-pakket opnemen in de Python-pakketeigenschap. Zie voor meer informatie: De Python-pakketeigenschap configureren. Voordat u toegang krijgt tot de aangepaste gegevens en het Bash- of Python-script uitvoert, raadt Cisco u aan de
URL die u wilt gebruiken, met behulp van de eigenschap Scripts. Je kunt ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2 testen door eerst de c uit te voerenurl softwaretool om het script te downloaden file. Voer in de gastshell de curl opdracht zoals weergegeven in de volgende voorbeeldample: curl -m 30 –opnieuw proberen 5 –gebruikersnaam:wachtwoord ftp://10.11.0.4/dir1/dir2/script_needs_credentials.py. Als de curl commando succesvol is, wordt een kopie van het Python-script gedownload, dat verifieert of de URL klopt.
De eigenschap Scriptreferenties configureren
Als u een FTP-server hebt opgegeven in de eigenschap Script en de server een gebruikersnaam en wachtwoord vereist, geeft u de gegevens op met behulp van de eigenschap Scriptreferenties.
Opmerking Als u anoniem toegang heeft tot de FTP-server, hoeft u de eigenschap Scriptreferenties niet te gebruiken. Configureer de eigenschap Scripts met a URL en parameters die overeenkomen met die in de eigenschap Scriptreferenties. Om de eigenschap Scriptreferenties te configureren, gebruikt u de volgende notatie: Sectie: Scriptreferenties public_url
Example
Sectie: Scriptreferenties
ftp://10.11.0.4/dir1/dir2/script1.py userfoo foospass De tweede regel in de eigenschap Scriptreferenties specificeert de waarden van de gebruikersnaam (userfoo) en het wachtwoord (foospass) voor het Python-script script1.py. Neem de naam op van de FTP-server die ook in de eigenschap Scripts staat. Een example regel in de eigenschap Scripts is: ftp://10.11.0.4/dir1/dir2/script1.py -a arg1 -s arg2. Zie bijvample 2 in Het configureren van de eigenschap Scripts,
De eigenschap van het Python-pakket configureren
Als een Python-pakket vereist is voor een script in de eigenschap Scripts en het geen deel uitmaakt van de standaard CentOS Linux release 7.1.1503, moet u informatie over het pakket opnemen in de eigenschap Python-pakket. Door de Python-pakketeigenschap op te nemen in de bootstrap filezorg jij ervoor dat de Cisco CSR 1000v het benodigde Python-pakket downloadt en installeert voordat de aangepaste data file die u hebt opgegeven in de eigenschap Scripts.
Configureer Python-pakketeigenschap
Gebruik de volgende indeling om de Python-pakketeigenschap te configureren:
Sectie: Python-pakket
pakketnaam [ versie ] [ sudo ] { [ pip_arg1 [ ..[ pip_arg9] ] ] } De argumenten: versie, sudo en pip_arg1 tot pip_arg9 zijn optioneel. U moet de argumenten voor het pip-commando tussen accolades “{“ en “}” plaatsen. Als u het versieargument opgeeft, wordt een specifiek versienummer gedownload. Als u het sudo-argument opgeeft, wordt het pakket gedownload als een sudo-gebruiker. Configuratie Bijvampde
Exampde 1
Sectie: Python-pakket
ncclient 0.5.2
In deze example specificeert de tweede regel van de Python-pakketeigenschap dat de pakketnaam “ncclient” is en de versie “0.5.2”. Wanneer de bootstrap file wordt geüpload, versie 0.5.2 van het ncclient-pakket wordt geïnstalleerd in de guestshell-container van de Cisco CSR 1000v.
Exampde 2
Sectie: Python-pakket
csr_gcp_ha 3.0.0 sudo {–user} In deze voorbeeldample specificeert de tweede regel van de Python-pakketeigenschap dat de pakketnaam “csr_gcp_ha” is en de versie “3.0.0”. Wanneer de bootstrap file wordt geüpload, wordt versie 3.0.0 van het csr_gcp_ha-pakket geïnstalleerd in de guestshell-container van de Cisco CSR 1000v. De volgende opdracht wordt uitgevoerd als sudo-gebruiker: pip install csr_gcp_ha=3.0.0 –user.
De eigenschap Licentie configureren
Configureer de licentie-eigenschap om het licentietechnologieniveau voor het Cisco CSR 1000v-exemplaar op te geven.
- Voer de eerste regel van het onroerend goed in het formaat in: Sectie: Licentie.
- Voer de tweede regel van de eigenschap in, die het technische niveau van de licentie specificeert, met behulp van de volgende notatie: TechPackage:tech_level .
Opmerking Zorg ervoor dat er geen spaties staan tussen “TechPackage:” en tech_level. De mogelijke tech_level-waarden zijn: ax, security, appx of ipbase.
Zorg ervoor dat tech_level in kleine letters staat.
Configuratie Example
Sectie: Licentie TechPackage: beveiliging
Toegang tot de aangepaste gegevens
- Om de aangepaste gegevens uit te voeren als een file Voer met behulp van de CLI het volgende script uit: Toegang krijgen tot de aangepaste gegevens file met behulp van de CLI
- Om de aangepaste gegevens uit te voeren als een file Voer met behulp van de CLI het volgende script uit: gcloud compute instances create –metadata-van-file=startup-script=Aangepastedata.txt –afbeelding
- Wanneer u deze opdracht uitvoert, wordt er een Cisco CSR 1000v VM gemaakt. De router wordt geconfigureerd met behulp van de opdrachten in het file: “Aangepaste gegevens.txt”.
Toegang tot de aangepaste gegevens vanaf de console Om toegang te krijgen tot de aangepaste gegevens vanaf de console, logt u in op de GCP-console. Klik op Compute Engine en selecteer Een exemplaar maken. Klik in het scherm Nieuw VM-exemplaar op Beheer > Opstartscript.
De aangepaste gegevensconfiguratie verifiëren
Nadat u het aangepaste gegevensscript hebt uitgevoerd, wordt de VM gemaakt en worden de configuratieopdrachten uitgevoerd. Om hetzelfde te verifiëren, gebruikt u de volgende opdrachten en scripts:
- show versie: Om te helpen bepalen of de licentie-eigenschap werkte, voert u in Cisco IOS XE CLI op de CSR 1000v de opdracht show versie in. Bijvoorbeeldample, toont de uitvoer een verwijzing naar de beveiligingslicentie.
- Om te zien of er fouten zijn opgetreden na het uitvoeren van opdrachten in de eigenschap scripts, kijkt u naar customdata.log file in de /bootflash/ /map. De scriptnaam.log file slaat alle uitvoer op die door het script naar STDOUT wordt verzonden.
- Om te verifiëren of de Python-eigenschap werkte, voert u de pip Freeze | in grep opdracht van de Guestshell naar view de momenteel geïnstalleerde Python-pakketten. Hier verwijst pakketnaam naar het pakket waarnaar u specifiek zoekt.
- Om de Cisco IOS XE-opdrachten in de IOS-configuratie-eigenschap te verifiëren, voert u de opdracht show running-configuration uit.
Documenten / Bronnen
 |
CISCO CSR 1000v Aangepaste gegevens gebruiken [pdf] Gebruikershandleiding CSR 1000v Aangepaste gegevens gebruiken, CSR 1000v, Aangepaste gegevens gebruiken, Aangepaste gegevens, Gegevens |