CISCO CSR 1000v usando dados personalizados
Implantando uma VM Cisco CSR 1000v usando dados personalizados
Ao implantar uma instância de máquina virtual Cisco CSR 1000v no Google Cloud Platform, você pode optar por usar a seção Startup Script no console de criação de VM para fornecer dados personalizados. Você também pode usar a CLI para acessar os dados personalizados para atingir vários objetivos de automação. Os dados personalizados no GCP permitem executar comandos de configuração do Cisco IOS XE, instalar pacotes Python no guestshell no Day0, executar scripts no guestshell no Day0 e fornecer informações de licenciamento para inicializar a instância CSR 1000v com um pacote de tecnologia desejado.
Versões suportadas
Você pode implantar uma VM Cisco CSR 1000v usando dados personalizados somente no Cisco IOS XE Gibraltar 16.12.1 ou versões posteriores.
- Editando os dados personalizados,
- Acessando os dados personalizados,
- Verificando a configuração de dados personalizados,
Editando os dados personalizados
Para editar os dados customizados, configure as seguintes propriedades:
- Configuração do iOS
- Roteiros
- Credenciais de script
- Pacote Python
- Licenciamento
Você pode colocar as propriedades em um file em qualquer ordem. As descrições de propriedades a seguir especificam dependências entre as propriedades, se houver. Veja o exampo bootstrap filesentado: https://github.com/csr1000v/customdata-examples.
Depois de definir as propriedades de dados personalizados, você pode acessar o script de inicialização ou os dados personalizados file usando a CLI conforme descrito na seção Acessando os dados personalizados.
Configurando a propriedade de configuração do IOS
Se desejar inicializar a configuração do IOS no Dia0, configure a propriedade Configuração do IOS. Veja a seguinte configuração do IOS exampem:
- Seção: Configuração do IOS
- nome de host CSR1
- interface GigabitEthernet1
- descrição “configuração de endereço IP estático”
- Endereço IP 10.0.0.1 255.255.255.0
- interface GigabitEthernet2
- descrição “Configuração de endereço IP baseada em DHCP”
- endereço IP dhcp
Após a primeira linha que diz Seção: Configuração do IOS, você pode inserir uma lista de comandos de configuração do Cisco IOS XE que deseja executar no roteador Cisco CSR 1000v.
Ao executar esse comando, a configuração do IOS anterior é aplicada ao roteador CSR 1000v em execução no GCP, no Dia 0.
Configurando a propriedade Scripts
A propriedade Scripts ajuda a automatizar a implantação de sua instância CSR1000v. Se você deseja executar um script Python ou Bash no Day0 no contexto guestshell, forneça o público URL e argumentos do python ou do script bash na propriedade Scripts. Um script deve incluir um trecho de código que inclua o caractere shebang (!) na primeira linha do script. Esta linha informa ao Cisco IOS-XE qual interpretador de script (Python ou Bash) você deve usar para analisar o código do script. Para example, a primeira linha de um script Python pode conter #!/usr/bin/env python, enquanto a primeira linha de um script Bash pode conter #!/bin/bash. Esta linha permite que o script Python ou Bash seja executado como código executável em um ambiente Linux. Quando você executa o script, ele é executado no contêiner guestshell da instância Cisco CSR 1000v. Para acessar o contêiner guestshell, use o comando do modo EXEC guestshell. Para obter mais informações sobre o comando guestshell, consulte o Guia de configuração de programação. Para configurar a propriedade Scripts, utilize o seguinte formato:
Seção: roteiros
público_url
Neste script, a primeira linha da propriedade deve ser Seção: Scripts. Na segunda linha da propriedade, insira o URL do script e dos argumentos do script. O script pode ser um script Python ou Bash. O script é executado em guestshell na primeira inicialização quando você carrega os dados personalizados file, ao criar a instância CSR1000v. Para view mais examparquivos dos scripts, consulte “scripts” em: https://github.com/csr1000v/customdata-examples. Além disso, consulte o seguinte exampos:
Exampo 1
Seção: Roteiro
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.
Exampo 2
Seção: Scripts
ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2
Essas duas linhas na propriedade Scripts recuperam o script.pyscript do servidor FTP com o endereço IP 10.11.0.4 e executam o script com o comando ./script.py -a arg1 -s arg2 Bash no contêiner guestshell do Cisco Instância CSR 1000v usando argumentos arg1 e arg2.
Observação Se um script na propriedade Scripts exigir um pacote Python que não esteja incluído na versão padrão do CentOS Linux (a versão do CentOS Linux atualmente usada pelo guestshell é a versão 7.1.1503 do CentOS Linux), você deverá incluir informações sobre o pacote Python na propriedade do pacote Python. Para obter mais informações, consulte: Configurando a propriedade do pacote Python, Antes de acessar os dados personalizados e executar o Bash ou o script Python, a Cisco recomenda que você teste o
URL que você pretende utilizar, utilizando a propriedade Scripts. Você pode testar ftp://10.11.0.4/dir1/dir2/script.py -a arg1 -s arg2 executando primeiro o curl ferramenta de software para baixar o script file. No guestshell, digite curl comando conforme mostrado no seguinte exampeu: curl -m 30 –repetir 5 –nome de usuário do usuário:senha ftp://10.11.0.4/dir1/dir2/script_needs_credentials.py. Se o curl comando for bem-sucedido, uma cópia do script Python será baixada, verificando se o URL está correto.
Configurando a propriedade de credenciais de script
Se você especificou um servidor FTP na propriedade Script e o servidor exigir credenciais de nome de usuário e senha, especifique as credenciais usando a propriedade Credenciais de Script.
Observação Se você puder acessar o servidor FTP anonimamente, não será necessário usar a propriedade Credenciais do script. Configure a propriedade Scripts com um URL e parâmetros que correspondem aos da propriedade Credenciais do script. Para configurar a propriedade Credenciais de script, utilize o seguinte formato: Seção: Credenciais de script public_url
Example
Seção: Credenciais de script
ftp://10.11.0.4/dir1/dir2/script1.py userfoo foospass A segunda linha na propriedade Credenciais do script especifica os valores das credenciais de nome de usuário (userfoo) e senha (foospass) para o script python script1.py. Inclua o nome do servidor FTP que também está na propriedade Scripts. Um exampA linha na propriedade Scripts é: ftp://10.11.0.4/dir1/dir2/script1.py -a arg1 -s arg2. Ver example 2 em Configurando a propriedade Scripts,
Configurando a propriedade do pacote Python
Se um pacote Python for exigido por um script na propriedade Scripts e não fizer parte da versão padrão do CentOS Linux 7.1.1503, você deverá incluir informações sobre o pacote na propriedade do pacote Python. Incluindo a propriedade do pacote Python no bootstrap file, você garante que o Cisco CSR 1000v baixe e instale o pacote Python necessário antes dos dados personalizados file que você especificou na propriedade Scripts.
Configurar propriedade do pacote Python
Para configurar a propriedade do pacote Python, use o seguinte formato:
Seção: pacote Python
package_name [ version ] [ sudo ] { [ pip_arg1 [ ..[ pip_arg9] ] ] } Os argumentos: version, sudo e pip_arg1 a pip_arg9 são opcionais. Você deve colocar os argumentos do comando pip entre chaves “{“ e “}”. Se você especificar o argumento version, um número de versão específico será baixado. Se você especificar o argumento sudo, o pacote será baixado como um usuário sudo. Configuração Exampos
Exampo 1
Seção: pacote Python
ncclient 0.5.2
Neste example, a segunda linha da propriedade do pacote Python especifica que o package_name é “ncclient” e a versão é “0.5.2”. Quando a inicialização file é carregado, a versão 0.5.2 do pacote ncclient é instalada no contêiner guestshell do Cisco CSR 1000v.
Exampo 2
Seção: pacote Python
csr_gcp_ha 3.0.0 sudo {–user} Neste example, a segunda linha da propriedade do pacote Python especifica que o package_name é “csr_gcp_ha” e a versão é “3.0.0”. Quando a inicialização file é carregado, a versão 3.0.0 do pacote csr_gcp_ha é instalada no contêiner guestshell do Cisco CSR 1000v. O seguinte comando é executado como um usuário sudo: pip install csr_gcp_ha=3.0.0 –user.
Configurando a propriedade Licença
Configure a propriedade da licença para especificar o nível de tecnologia de licença para a instância Cisco CSR 1000v.
- Insira a primeira linha do imóvel no formato: Seção: Licença.
- Insira a segunda linha da propriedade, que especifica o nível técnico da licença, usando o seguinte formato: TechPackage:tech_level .
Observação Certifique-se de que não haja espaços entre “TechPackage:” e tech_level. Os valores possíveis de tech_level incluem: ax, security, appx ou ipbase.
Certifique-se de que tech_level esteja em letras minúsculas.
Configuração Example
Seção: Licença TechPackage:segurança
Acessando os dados personalizados
- Para executar os dados personalizados como um file usando a CLI, execute o seguinte script: Acessando os dados customizados file usando a CLI
- Para executar os dados personalizados como um file usando a CLI, execute o seguinte script: gcloud compute instances create –metadados-de-file=startup-script=Customdata.txt –imagem
- Ao executar este comando, uma VM Cisco CSR 1000v é criada. O roteador é configurado usando os comandos no file: “Customdata.txt”.
Acessando os dados personalizados do console Para acessar os dados personalizados do console, faça login no console do GCP. Clique em Compute Engine e selecione Criar uma instância. Na tela Nova instância de VM, clique em Gerenciamento > Script de inicialização.
Verificando a configuração de dados personalizados
Depois de executar o script de dados customizado, a VM será criada e os comandos de configuração serão executados. Para verificar o mesmo, use os seguintes comandos e scripts:
- show version: Para ajudar a determinar se a propriedade da licença funcionou, na CLI do Cisco IOS XE no CSR 1000v, insira o comando show version. Para examparquivo, a saída exibe uma referência à licença de segurança.
- Para ver se ocorreram erros após a execução de comandos na propriedade scripts, consulte customdata.log file no /bootflash/ /diretório. O scriptname.log file armazena qualquer saída enviada para STDOUT pelo script.
- Para verificar se a propriedade Python funcionou, insira pip freeze | grep comando do Guestshell para view os pacotes Python atualmente instalados. Aqui, package-name refere-se ao pacote que você está procurando especificamente.
- Para verificar os comandos do Cisco IOS XE na propriedade Configuração do IOS, execute o comando show running-configuration.
Documentos / Recursos
 |
CISCO CSR 1000v usando dados personalizados [pdf] Manual do Usuário CSR 1000v usando dados personalizados, CSR 1000v, usando dados personalizados, dados personalizados, dados |