Instalando docker usando la red cubana

Este sería el tercer tutorial de como instalar Docker en Cuba. A diferencia de los otros 2, en este se pretende no usar ningún recurso fuera de cuba y que todo quede en la intranet cubana. Gracias a Argenis Ochoa González(AKA @linux8a) por el aporte a la comunidad.

Objetivo:

Tener todo lo necesario para trabajar con Docker. Usando solamente los recursos que disponemos dentro de nuestra red. Instalaremos Docker, docker-compose y usaremos como mirror el registro de la universidad de las villas. Como extra montaremos localmente un servidor registro de docker y dos imágenes la cual nos ayudara en las implementaciones futuras.

Recopilación:

Este post es una recopilación de todas las notas interactivas del canal de telegram de dockercuba

Requerimiento:

• Disponer de conexión a internet.

Nota: Puede usar nauta hogar o la red de datos de etecsa. Los recursos que usaremos están libres de costo.

• Una computadora o una vm con una distro Gnu/Linux Ubuntu

Nota: Estaré usando en esta guía un Ubuntu 20.04. Pero puedes seguirla con cualquier otra versión o con Debian. Cambiando en el source.list por el repo pertinente https://repos.uclv.edu.cu/ubuntu/ o https://repos.uclv.edu.cu/debian/

Comencemos editando nuestro source.list . Para no hacer el ajuste a mano usare el comando sed para cambiar el repo de archive.ubuntu.com a repos.uclv.edu.cu

buscamos nuestro fichero source.list
Ruta: /etc/apt/sources.list

Agregamos estos repos:
sudo sed -i 's/archive.ubuntu.com/repos.uclv.edu.cu/' /etc/apt/sources.list
sudo sed -i 's/security.ubuntu.com/repos.uclv.edu.cu/' /etc/apt/sources.list

Y actualizamos el sistema

sudo apt update && sudo apt upgrade

Instalamos docker y docker-compose:

sudo apt install docker.io docker-compose -y

Si estamos detras de un proxy, crearemos el fichero proxy.conf en al siguiente ruta /etc/apt/apt.conf.d/ y dentro agregamos estas lineas:

Acquire {
HTTP::proxy "http://username:password@ip:port";
HTTPS::proxy "http://username:password@ip:port";
ftp::proxy "http://username:password@ip:port";
}

Nota: Si no existen usuario y contraseña para validar, solo se pone lo que continua después de @, en formato ip:port.

Comprobamos

sudo docker version
o
docker version

El resultado del comando será algo parecido a esto:

sudo docker-compose version 
o 
docker-compose version

Ahora crearemos el daemon.json para usar como mirror el registro de la universidad de las villas.

nano /etc/docker/daemon.json

Agregamos las siguientes lineas:

{
        "registry-mirrors": [
                "https://docker.uclv.cu"
        ]
}

NOTA: Si necesitas cambiar la subnet por defecto de docker. Pon las siguientes líneas al final del archivo como se explica aqui:

{
        "registry-mirrors": [
                "https://docker.uclv.cu"
        ],
        "bip":"10.200.0.1/24",
	"default-address-pools":[
		{"base":"10.201.0.0/16","size":24},
		{"base":"10.202.0.0/16","size":24}
	]
}

Cada vez que ajuste el daemon.json debe reiniciar el servicio o hacer un reload

sudo service docker reload
o
sudo service docker restart

Probemos con la imagen hello-word

sudo docker run hello-world
o
sudo docker run docker.uclv.cu/hello-world

NOTA: Si desea asignar permisos a una cuenta no root para usar Docker haga lo siguiente:

sudo usermod -aG docker elusuarioquedeseasusarcondocker

Debo advertir que agregar un usuario al grupo docker le otorga la capacidad de ejecutar contenedores que se pueden usar para obtener privilegios de root en el host de Docker. Para conocer más del tema: Docker Daemon Attack Surface

Si desea hacer esta parte de forma desatendida les dejo este script:

#!/bin/bash

# cambiando source.list
echo "Cambiando source.list de archive.ubuntu.com a repos.uclv.edu.cu"

sudo sed -i 's/archive.ubuntu.com/repos.uclv.edu.cu/' /etc/apt/sources.list
sudo sed -i 's/security.ubuntu.com/repos.uclv.edu.cu/' /etc/apt/sources.list

# actualizando

sudo apt update && sudo apt upgrade -y

# Instalando docker docker-compose

sudo apt install docker.io docker-compose -y

# creando daemon.json

sudo bash -c 'cat << EOF > /etc/docker/daemon.json
{
        "registry-mirrors": [
                "https://docker.uclv.cu"
        ]
}
EOF'
sleep 10
# Reiniciando docker
echo "Reiniciando servicio docker"
sudo service docker restart

Docker Registry server:

Corresponde el turno para crear nuestro docker registry local. Alternativas para disponer de un registry hay varias tales como: Nexus, Harbor etc. Implementaremos registry oficial de Hub Network por los pocos recursos que usa. La imagen que usaremos implementa un docker registry HTTP API v2. Para nuestro proyecto crearemos una carpeta llamada registry.

mkdir registry
cd registry

Creamos el fichero docker-compose.yml y dentro agregamos:

nano docker-compose.yml

Y peguemos dentro:

version: '3.5'

services: 
     registry:
        image: docker.uclv.cu/registry:2.7.1
        container_name: registry
        networks:
            - hub_network
        restart: always
        ports: 
            - '5000:5000'
        volumes: 
            - ./registry-data:/var/lib/registry
            - ./config.yml:/etc/docker/registry/config.yml
        environment:
         REGISTRY_PROXY_REMOTEURL: "https://docker.uclv.cu"
         # Si navegas por proxy descomenta las líneas de abajo y pon la ip y puerto del proxy
         #HTTP_PROXY: ip:puerto
         #HTTPS_PROXY:  ip:puerto
         #NO_PROXY: localhost,127.0.0.1,10.0.0.7
         #no_proxy: localhost,127.0.0.1,10.0.0.7

networks:
  hub_network:
    driver: bridge

Nuestro docker compose hace referencia a config.yml el cual tendremos que crear

nano config.yml

Contendido:

version: 0.1

log:
  fields:
    service: registry
storage:
  cache:
    blobdescriptor: inmemory
  filesystem:
    rootdirectory: /var/lib/registry
delete:
  enabled: true
http:
  addr: :5000
  headers:
    X-Content-Type-Options: [nosniff]
health:
  storagedriver:
    enabled: true
    interval: 10s
    threshold: 3

Levantamos el servicio:

sudo docker-compose up -d

Para usar tu nuevo servidor registry agrega esta líneas en daemon.json

nano /etc/docker/daemon.json

Agregar la final

{
        "registry-mirrors": ["http://registry:5000", "https://docker.uclv.cu"],
        "insecure-registries":["http://registry:5000", "https://docker.uclv.cu"]
}

Reiniciamos el servicio

sudo service docker restart

Para que el host pueda resolver el nombre del registry que asignamos debemos cargarlo al fichero /etc/hosts

nano /etc/hosts

Agregar:

tuipdelhost registry

Extra

Aprovecharemos e implementaremos 2 imágenes las cuales nos facilitaran la vida. La primera tiene que ver con la documentación de docker y la segunda con las imágenes y opciones que podemos usar. Como mencionamos en el titulo aprovecharemos todo lo que tenemos a nuestro alcance en la red de cuba.

Documentación de Docker

Puedes usar este recurso, el cual está libre de costo en https://docker-docs.uclv.cu. Tienes la opción de Implementarlo de una de las dos formas. Usando docker cli o corriendo docker-compose. Aprovecharemos y llamaremos la imagen desde nuestro registry local. Para que lo baje y nos lo deje guardado en él.

Desplegándola con docker cli

docker run -d -p 4000:4000 registry:5000/docs/docker.github.io

Desplegándola con docker-compose

Crearemos la carpeta para una mayor organización

mkdir docker_docs
cd docker_docs

Creamos el fichero docker-compose.yml

nano docker-compose.yml

Agregamos:

version: "3.7"

services:
    docker_docs:
        image: registry:5000/docs/docker.github.io
        container_name: docker_docs
        expose:
            - "4000"

Para levantarlo damos un simple

docker-compose up -d

Accedemos a él abriendo nuestro navegador http://ip:4000

Docsimagesdocker

Esta imagen está hecha para tener la ayuda completa de las imágenes oficiales de Docker desconectado; sus opciones, tag etc. Está pensada para usar por los miembros de la comunidad docker de cuba. Pues para acceder https://hub.docker.com/ es necesario usar vpn. Con esta imagen tendremos todo lo necesario desde la red de cuba.

Desplegándola con docker cli

docker run -d -p 8000:8000 registry:5000/linux8a/docsimagesdocker:v2.0.1

Desplegándola con docker-compose

mkdir documentacionimagenesdocker
cd documentacionimagenesdocker

Creamos el fichero docker-compose.yml

nano docker-compose.yml

Agregar:

version: '3.3'

services:
  documentacionimagenesdocker:
    image: registry:5000/linux8a/docsimagesdocker:v2.0.1 
    restart: always
    ports:
      - 8000:8000
    volumes:
      - /etc/localtime:/etc/localtime:ro  
      - /etc/timezone:/etc/timezone:ro

Accedemos a él abriendo nuestro navegador http://ip:8000

Conclusiones

Esto es una pequeña muestra de lo que podemos lograr para aprender y hacer crecer más a nuestra comunidad logrando aprovechar los recursos que tenemos en nuestra mano. Si deseas puedes implementar otros servicios https://github.com/linux8a/Docker-Cuba