Introdução

Este original descreve as etapas usadas para instalar o estivador compõe o pacote dentro do shell da festança NX-OS.

Funcionalidade do estivador do apoio dos dispositivos do 3000 e 9000 Series do nexo de Cisco dentro do shell da festança que começa com liberação NX-OS 9.2(1). Como descrito pelo estivador compõe a documentação, “Compose é uma ferramenta para definir e executar aplicativos do estivador do multi-recipiente.” O estivador compõe permite desenvolvedores de aplicativo definir todos os serviços que constituem um aplicativo dentro de um único arquivo YAML nomeado “docker-compose.yml”. Então, com um comando único, todos aqueles serviços podem ser criados, construído, e começado. Além disso, todos os serviços podem ser parados e monitorado de dentro do estivador compõe o conjunto de comandos.

Quando a funcionalidade do estivador for apoiada nativamente dentro do shell da festança NX-OS, o estivador Compose deve ser instalado separadamente.

Pré-requisitos

Requisitos

Este original exige o shell da festança ser permitido em seu dispositivo do nexo de Cisco. Refira “a seção da festança de acesso” do capítulo da festança no guia do Programmability do 9000 Series NX-OS do nexo de Cisco para que as instruções permitam o shell da festança.

Este original exige o shell da festança ser configurado como um cliente de DNS capaz de resolver nomes de host do domínio aos IP address. Refira o original para que as instruções configurem servidores DNS dentro do shell da festança.

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Plataforma do nexo 9000 que parte da liberação NX-OS 9.2(1)
• Plataforma do nexo 3000 que parte da liberação NX-OS 9.2(1)

As informações apresentadas neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a sua rede estiver ativa, certifique-se de que entende o impacto potencial de qualquer comando.

Configurando proxys HTTP/HTTPS

Se seu ambiente exige o uso do proxy HTTP ou HTTPS, o shell da festança deverá ser configurado para usar estes proxys antes que o estivador Compose possa ser instalado.

Log no shell da festança como o usuário de raiz através do comando su - do sudo da festança da corrida.

Nexus# run bash sudo su -
root@Nexus#whoami
root

Temporariamente configurando proxys HTTP/HTTPS

Para configurar temporariamente proxys HTTP/HTTPS para esta sessão, use o comando da exportação definir os variáveis de ambiente do “http_proxy” e do “https_proxy”. Um exemplo deste é mostrado abaixo, onde “proxy.example-domain.com” é o hostname de um servidor proxy hipotético.

root@Nexus#export http_proxy=http://proxy.example-domain.com:80/
root@Nexus#export https_proxy=https://proxy.example-domain.com:80/ 

Confirme que os variáveis de ambiente estão configurados como desejado usando o eco $http_proxy e ecoe comandos $https_proxy, como demonstrado abaixo:

root@Nexus#echo $http_proxy
http://proxy.example-domain.com:80/
root@Nexus#echo $https_proxy
https://proxy.example-domain.com:80/

Os valores atribuídos a estes variáveis de ambiente serão cancelados quando a sessão é terminada, e deverão ser reconfigurados cada vez que o shell da festança é incorporado. No exemplo abaixo, a sessão da festança onde a configuração acima é retirada, retornando o alerta a NX-OS. Então, uma sessão nova ao shell da festança é criada, onde os variáveis de ambiente foram cancelados.

root@Nexus#export http_proxy=http://proxy.example-domain.com:80/
root@Nexus#export https_proxy=https://proxy.example-domain.com:80/
root@Nexus#echo $http_proxy
http://proxy.example-domain.com:80/
root@Nexus#echo $https_proxy
https://proxy.example-domain.com:80/
root@Nexus#exit
Nexus# run bash sudo su -
root@Nexus#echo $http_proxy

root@Nexus#echo $https_proxy

root@Nexus#

Permanentemente configurando proxys HTTP/HTTPS

Para configurar permanentemente proxys HTTP/HTTPS para todas as sessões para um usuário específico que incorpore o shell da festança, os variáveis de ambiente do “http_proxy” e do “https_proxy” deve ser exportado automaticamente cada vez que todo o usuário entra. Isto pode ser realizado adicionando comandos da exportação ao arquivo .bash_profile situado no diretório de usuário, que da festança cargas automaticamente quando esse log de usuário no shell da festança. Um exemplo deste é mostrado abaixo, onde “proxy.example-domain.com” é o hostname de um servidor proxy hipotético.

root@Nexus#pwd
/root
root@Nexus#ls -al
total 28
drwxr-xr-x  5 root floppy         200 Dec  6 13:22 .
drwxrwxr-t 62 root network-admin 1540 Nov 26 18:10 ..
-rw-------  1 root root          9486 Dec  6 13:22 .bash_history
-rw-r--r--  1 root floppy         703 Dec  6 13:22 .bash_profile
drwx------  3 root root            60 Nov 26 18:10 .config
drwxr-xr-x  2 root root            60 Nov 26 18:11 .ncftp
-rw-------  1 root root             0 Dec  5 14:37 .python-history
-rw-------  1 root floppy          12 Nov  5 05:38 .rhosts
drwxr-xr-x  2 root floppy          60 Nov  5 06:17 .ssh
-rw-------  1 root root          5499 Dec  6 13:20 .viminfo
root@Nexus#echo "export http_proxy=http://proxy.example-domain.com:80/" >> .bash_profile
root@Nexus#echo "export https_proxy=https://proxy.example-domain.com:80/" >> .bash_profile
root@Nexus#cat .bash_profile | grep proxy
export http_proxy=http://proxy.example-domain.com:80/
export https_proxy=https://proxy.example-domain.com:80/
root@Nexus#exit
Nexus# run bash sudo su -
root@Nexus#echo $http_proxy
http://proxy.example-domain.com:80/
root@Nexus#echo $https_proxy
https://proxy.example-domain.com:80/

Se um deseja configurar proxys específicos HTTP/HTTPS para todas as sessões para todos os usuários que incorporam o shell da festança, adicione estes comandos da exportação ao arquivo de /etc/profile. A festança carrega automaticamente este arquivo primeiramente quando todos os log de usuário no shell da festança - em consequência, todos os usuários que registram no shell da festança terão seus proxys HTTP/HTTPS configurados em conformidade.

Um exemplo deste é mostrado abaixo, onde “proxy.example-domain.com” é o hostname de um servidor proxy hipotético. A conta de usuário “estivador-admin” é configurada então com o shelltype da festança, que permite que a conta de usuário registre diretamente no shell da festança ao remotamente alcançar o dispositivo. O SSH é usado então para alcançar o IP address mgmt0 (192.0.2.1) do dispositivo do nexo através do Gerenciamento VRF usando a conta de usuário estivador-admin. O exemplo mostra que os variáveis de ambiente do “http_proxy” e do “https_proxy” estiveram ajustados, mesmo quando uma conta de usuário brandnew foi registrada no shell da festança.

root@Nexus#echo "export http_proxy=http://proxy.example-domain.com:80/" >> /etc/profile
root@Nexus#echo "export https_proxy=https://proxy.example-domain.com:80/" >> /etc/profile
root@Nexus#cat /etc/profile | grep proxy
export http_proxy=http://proxy.example-domain.com:80/
export https_proxy=https://proxy.example-domain.com:80/
root@Nexus#exit
Nexus# run bash sudo su -
root@Nexus#echo $http_proxy
http://proxy.example-domain.com:80/
root@Nexus#echo $https_proxy
https://proxy.example-domain.com:80/
root@Nexus#exit
Nexus# configure terminal
Nexus(config)# username docker-admin role dev-ops password example_password
Nexus(config)# username docker-admin shelltype bash
Nexus(config)# exit
Nexus# ssh docker-admin@192.0.2.1 vrf management
Password:
-bash-4.3$ whoami
docker-admin
-bash-4.3$ echo $http_proxy
http://proxy.example-domain.com:80/
-bash-4.3$ echo $https_proxy
https://proxy.example-domain.com:80/

Instalando o estivador compõe

Para instalar o estivador compõe, um deve usar a utilidade do wget para transferir a liberação binária a mais atrasada do estivador compõem, a seguir colocam esse binário no diretório de /usr/bin.

1. Determine a versão estável a mais atrasada do estivador compõem disponível com as liberações disponíveis as mais atrasadas no estivador compõem a página de GitHub. Encontre o número de versão para a versão estável a mais atrasada para a parte superior do Web page. Na altura desta escrita, a versão estável a mais atrasada é 1.23.2.

2. Craft a URL para o estivador compõem o binário substituindo {tarde-versão} na URL abaixo com o número de versão da versão estável a mais atrasada encontrada na etapa precedente:

https://github.com/docker/compose/releases/download/{latest-version}/docker-compose-Linux-x86_64

Por exemplo, a URL para 1.23.2 na altura desta escrita é como segue: https://github.com/docker/compose/releases/download/1.23.2/docker-compose-Linux-x86_64

3. Incorpore o shell da festança como raiz do alerta NX-OS com o comando su - do sudo da festança da corrida, como demonstrado abaixo:

Nexus# run bash sudo su -
root@Nexus#whoami
root

4. Caso necessário, mude o contexto namespace da rede do shell da festança a um namespace com DNS e conectividade de Internet. Os namespaces da rede são logicamente idênticos a NX-OS VRF. O exemplo abaixo demonstra como comutar ao contexto namespace da rede de gerenciamento, que tem o DNS e a conectividade de Internet neste ambiente específico.

root@Nexus#ip netns exec management bash
root@Nexus#ping cisco.com -c 5
PING cisco.com (72.163.4.161) 56(84) bytes of data.
64 bytes from www1.cisco.com (72.163.4.161): icmp_seq=1 ttl=239 time=29.2 ms
64 bytes from www1.cisco.com (72.163.4.161): icmp_seq=2 ttl=239 time=29.3 ms
64 bytes from www1.cisco.com (72.163.4.161): icmp_seq=3 ttl=239 time=29.3 ms
64 bytes from www1.cisco.com (72.163.4.161): icmp_seq=4 ttl=239 time=29.2 ms
64 bytes from www1.cisco.com (72.163.4.161): icmp_seq=5 ttl=239 time=29.2 ms

--- cisco.com ping statistics ---
5 packets transmitted, 5 received, 0% packet loss, time 4000ms
rtt min/avg/max/mdev = 29.272/29.299/29.347/0.218 ms

5. Inscreva o comando seguinte, substituindo {estivador-URL} com a URL criada na etapa precedente: wget {estivador-URL} - O /usr/bin/docker-compose. Um exemplo deste comando que executa é mostrado abaixo, usando https://github.com/docker/compose/releases/download/1.23.2/docker-compose-Linux-x86_64 como a substituição URL para {estivador-URL}:

root@Nexus#wget https://github.com/docker/compose/releases/download/1.23.2/docker-compose-Linux-x86_64 -O /usr/bin/docker-compose
--2018-12-06 15:24:36--  https://github.com/docker/compose/releases/download/1.23.2/docker-compose-Linux-x86_64
Resolving proxy.example-domain.com... 2001:DB8::1, 192.0.2.100
Connecting to proxy.example-domain.com|2001:DB8::1|:80... failed: Cannot assign requested address.
Connecting to proxy.example-domain.com|192.0.2.100|:80... connected.
Proxy request sent, awaiting response... 302 Found
Location: https://github-production-release-asset-2e65be.s3.amazonaws.com/15045751/67742200-f31f-11e8-947e-bd56efcd8886?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIWNJYAX4CSVEH53A%2F20181206%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20181206T152526Z&X-Amz-Expires=300&X-Amz-Signature=dfccfd5a32a908040fd8c18694d6d912616f644e7ab3564c6b4ce314a0adbbc7&X-Amz-SignedHeaders=host&actor_id=0&response-content-disposition=attachment%3B%20filename%3Ddocker-compose-Linux-x86_64&response-content-type=application%2Foctet-stream [following]
--2018-12-06 15:24:36--  https://github-production-release-asset-2e65be.s3.amazonaws.com/15045751/67742200-f31f-11e8-947e-bd56efcd8886?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIWNJYAX4CSVEH53A%2F20181206%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20181206T152526Z&X-Amz-Expires=300&X-Amz-Signature=dfccfd5a32a908040fd8c18694d6d912616f644e7ab3564c6b4ce314a0adbbc7&X-Amz-SignedHeaders=host&actor_id=0&response-content-disposition=attachment%3B%20filename%3Ddocker-compose-Linux-x86_64&response-content-type=application%2Foctet-stream
Connecting to proxy.example-domain.com|192.0.2.100|:80... connected.
Proxy request sent, awaiting response... 200 OK
Length: 11748168 (11M) [application/octet-stream]
Saving to: ‘/usr/bin/docker-compose’

/usr/bin/docker-compose                                   100%[=======================================================================================================================================>]  11.20M  6.44MB/s   in 1.7s   

2018-12-06 15:24:38 (6.44 MB/s) - ‘/usr/bin/docker-compose’ saved [11748168/11748168]

root@Nexus#

6. Altere as permissões do arquivo binário de /usr/bin/docker-compose tais que é executável usando o comando do chmod +x /usr/bin/docker-compose. Isto é demonstrado abaixo:

root@Nexus#docker-compose
bash: /usr/bin/docker-compose: Permission denied
root@Nexus#chmod +x /usr/bin/docker-compose
root@Nexus#docker-compose
Define and run multi-container applications with Docker.

Usage:
  docker-compose [-f <arg>...] [options] [COMMAND] [ARGS...]
  docker-compose -h|--help

Options:
  -f, --file FILE Specify an alternate compose file
                              (default: docker-compose.yml)
  -p, --project-name NAME Specify an alternate project name
                              (default: directory name)
  --verbose Show more output
  --log-level LEVEL Set log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
  --no-ansi Do not print ANSI control characters
  -v, --version Print version and exit
  -H, --host HOST Daemon socket to connect to

  --tls Use TLS; implied by --tlsverify
  --tlscacert CA_PATH Trust certs signed only by this CA
  --tlscert CLIENT_CERT_PATH Path to TLS certificate file
  --tlskey TLS_KEY_PATH Path to TLS key file
  --tlsverify Use TLS and verify the remote
  --skip-hostname-check Don't check the daemon's hostname against the
                              name specified in the client certificate
  --project-directory PATH Specify an alternate working directory
                              (default: the path of the Compose file)
  --compatibility If set, Compose will attempt to convert deploy
                              keys in v3 files to their non-Swarm equivalent

Commands:
  build              Build or rebuild services
  bundle             Generate a Docker bundle from the Compose file
  config             Validate and view the Compose file
  create             Create services
  down               Stop and remove containers, networks, images, and volumes
  events             Receive real time events from containers
  exec               Execute a command in a running container
  help               Get help on a command
  images             List images
  kill               Kill containers
  logs               View output from containers
  pause              Pause services
  port               Print the public port for a port binding
  ps                 List containers
  pull               Pull service images
  push               Push service images
  restart            Restart services
  rm                 Remove stopped containers
  run                Run a one-off command
  scale              Set number of containers for a service
  start              Start services
  stop               Stop services
  top                Display the running processes
  unpause            Unpause services
  up                 Create and start containers
  version            Show the Docker-Compose version information

Verificando o estivador compõe a funcionalidade

Um pode verificar que o estivador Compose está instalado com sucesso e funcionando criando e executando um arquivo pequeno docker-compose.yml. As etapas abaixo do exemplo com este processo.

root@Nexus#mkdir docker-compose-example
root@Nexus#cd docker-compose-example/
root@Nexus#ls -al
total 0
drwxr-xr-x 2 root root    40 Dec  6 15:31 .
drwxr-xr-x 6 root floppy 260 Dec  6 15:31 ..
root@Nexus#vi docker-compose.yml
root@Nexus#cat docker-compose.yml
version: "3"
services:
  example_mongo:
    image: mongo:latest
    container_name: "example_mongo"
  example_alpine:
    image: alpine:latest
    container_name: "example_alpine"
root@Nexus#docker-compose up
Creating network "docker-compose-example_default" with the default driver
Pulling example_mongo (mongo:latest)...
latest: Pulling from library/mongo
7b8b6451c85f: Pull complete
ab4d1096d9ba: Pull complete
e6797d1788ac: Pull complete
e25c5c290bde: Pull complete
45aa1a4d5e06: Pull complete
b7e29f184242: Pull complete
ad78e42605af: Pull complete
1f4ac0b92a65: Pull complete
55880275f9fb: Pull complete
bd0396c9dcef: Pull complete
28bf9db38c03: Pull complete
3e954d14ae9b: Pull complete
cd245aa9c426: Pull complete
Creating example_mongo  ... done
Creating example_alpine ... done
Attaching to example_alpine, example_mongo
example_mongo     | 2018-12-06T15:36:18.710+0000 I CONTROL  [main] Automatically disabling TLS 1.0, to force-enable TLS 1.0 specify --sslDisabledProtocols 'none'
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten] MongoDB starting : pid=1 port=27017 dbpath=/data/db 64-bit host=c4f095f9adb0
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten] db version v4.0.4
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten] git version: f288a3bdf201007f3693c58e140056adf8b04839
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten] OpenSSL version: OpenSSL 1.0.2g  1 Mar 2016
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten] allocator: tcmalloc
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten] modules: none
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten] build environment:
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten]     distmod: ubuntu1604
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten]     distarch: x86_64
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten]     target_arch: x86_64
example_mongo     | 2018-12-06T15:36:18.717+0000 I CONTROL  [initandlisten] options: { net: { bindIpAll: true } }
example_mongo     | 2018-12-06T15:36:18.717+0000 I STORAGE  [initandlisten] 
example_mongo     | 2018-12-06T15:36:18.717+0000 I STORAGE  [initandlisten] ** WARNING: Using the XFS filesystem is strongly recommended with the WiredTiger storage engine
example_mongo     | 2018-12-06T15:36:18.717+0000 I STORAGE  [initandlisten] **          See http://dochub.mongodb.org/core/prodnotes-filesystem
example_mongo     | 2018-12-06T15:36:18.717+0000 I STORAGE  [initandlisten] wiredtiger_open config: create,cache_size=31621M,session_max=20000,eviction=(threads_min=4,threads_max=4),config_base=false,statistics=(fast),log=(enabled=true,archive=true,path=journal,compressor=snappy),file_manager=(close_idle_time=100000),statistics_log=(wait=0),verbose=(recovery_progress),
example_alpine exited with code 0
example_mongo     | 2018-12-06T15:36:19.722+0000 I STORAGE  [initandlisten] WiredTiger message [1544110579:722686][1:0x7f9d5de45a40], txn-recover: Set global recovery timestamp: 0
example_mongo     | 2018-12-06T15:36:19.745+0000 I RECOVERY [initandlisten] WiredTiger recoveryTimestamp. Ts: Timestamp(0, 0)
example_mongo     | 2018-12-06T15:36:19.782+0000 I CONTROL  [initandlisten] 
example_mongo     | 2018-12-06T15:36:19.782+0000 I CONTROL  [initandlisten] ** WARNING: Access control is not enabled for the database.
example_mongo     | 2018-12-06T15:36:19.782+0000 I CONTROL  [initandlisten] **          Read and write access to data and configuration is unrestricted.
example_mongo     | 2018-12-06T15:36:19.782+0000 I CONTROL  [initandlisten] 
example_mongo     | 2018-12-06T15:36:19.783+0000 I STORAGE  [initandlisten] createCollection: admin.system.version with provided UUID: dc0b3249-576e-4546-9d97-de841f5c45c4
example_mongo     | 2018-12-06T15:36:19.810+0000 I COMMAND  [initandlisten] setting featureCompatibilityVersion to 4.0
example_mongo     | 2018-12-06T15:36:19.814+0000 I STORAGE  [initandlisten] createCollection: local.startup_log with generated UUID: 2f9820f5-11ad-480d-a46c-c58222beb0ad
example_mongo     | 2018-12-06T15:36:19.841+0000 I FTDC     [initandlisten] Initializing full-time diagnostic data capture with directory '/data/db/diagnostic.data'
example_mongo     | 2018-12-06T15:36:19.842+0000 I NETWORK  [initandlisten] waiting for connections on port 27017
example_mongo     | 2018-12-06T15:36:19.842+0000 I STORAGE  [LogicalSessionCacheRefresh] createCollection: config.system.sessions with generated UUID: d4aeac07-29fd-4208-9f83-394b4af648a2
example_mongo     | 2018-12-06T15:36:19.885+0000 I INDEX    [LogicalSessionCacheRefresh] build index on: config.system.sessions properties: { v: 2, key: { lastUse: 1 }, name: "lsidTTLIndex", ns: "config.system.sessions", expireAfterSeconds: 1800 }
example_mongo     | 2018-12-06T15:36:19.885+0000 I INDEX    [LogicalSessionCacheRefresh]          building index using bulk method; build may temporarily use up to 500 megabytes of RAM
example_mongo     | 2018-12-06T15:36:19.886+0000 I INDEX    [LogicalSessionCacheRefresh] build index done.  scanned 0 total records. 0 secs
^C
Gracefully stopping... (press Ctrl+C again to force)
Stopping example_mongo  ... done
root@Nexus#

Cuidado: Assegure-se de que quando o comando da estivador-composição for executado, esteja feito assim dentro do contexto de um namespace da rede que tenha o DNS e a conectividade de Internet. Se não, o estivador Compose não poderá puxar imagens pedidas do hub do estivador.

Note: Para retirar-se um aplicativo do estivador do multi-recipiente começou pelo estivador compõe quando anexado ao estivador compõe a sessão, pressiona a combinação chave do “Ctrl+C”.

Informações Relacionadas

• O estivador compõe a documentação de instalação
• O estivador compõe a vista geral da documentação
• Guia do Programmability do 9000 Series NX-OS do nexo de Cisco, liberação 9.x
• Guia do Programmability do 9000 Series NX-OS do nexo de Cisco, liberação 7.x
• Guia do Programmability do 9000 Series NX-OS do nexo de Cisco, liberação 6.x
• Guia do Programmability do 3000 Series NX-OS do nexo de Cisco, liberação 9.x
• Guia do Programmability do 3000 Series NX-OS do nexo de Cisco, liberação 7.x
• Guia do Programmability do 3000 Series NX-OS do nexo de Cisco, liberação 6.x
• Guia do Programmability do 3500 Series NX-OS do nexo de Cisco, liberação 9.x
• Guia do Programmability do 3500 Series NX-OS do nexo de Cisco, liberação 7.x
• Guia do Programmability do 3500 Series NX-OS do nexo de Cisco, liberação 6.x
• Guia do Programmability do 3600 Series NX-OS do nexo de Cisco, liberação 9.x
• Guia do Programmability do 3600 Series NX-OS do nexo de Cisco, liberação 7.x
• Programmability e automatização com Cisco NX-OS aberto