Instala la infraestructura

El modo privado de Anthos es una versión de Anthos que puede ejecutarse por completo en Internet en un entorno aislado del aire. Puedes usar el modo privado de Anthos para ejecutar cargas de trabajo altamente regulados en tus instalaciones, sin dejar de beneficiarse de muchas de las ventajas de una infraestructura nativa de la nube.

Introducción

En este documento, se te guiará a través de la instalación del modo privado de Anthos como operador de infraestructura, que es responsable de la capa de la infraestructura, como las máquinas de equipos físicos, las herramientas de redes, el almacenamiento y el sistema operativo. Para este proceso, es necesario tener experiencia previa en la administración del sistema y en Kubernetes.

La arquitectura del modo privado de Anthos es similar a la arquitectura de la versión conectada de Anthos en equipos físicos: hay un clúster de administrador que usas para crear y administrar usuario.. Tus cargas de trabajo se ejecutan en los clústeres de usuario. También tienes una estación de trabajo de administrador, que es una sola máquina que contiene las herramientas necesarias para instalar y administrar la implementación del modo privado de Anthos.

En comparación con la versión conectada de Anthos del equipo operativo, el modo privado de Anthos incluye 3 componentes adicionales:

Un registro de contenedor opcional que se ejecuta en la estación de trabajo de administrador para almacenar todas las imágenes de contenedor de Anthos (necesarias en una situación en la que no tienes acceso a Container Registry).
Un centro de administración basado en la Web del modo privado de Anthos que se ejecuta en el clúster de administrador. Te permite administrar todos los recursos que conforman la implementación de Anthos, incluidas las máquinas, AddressPools y los clústeres de usuario. También administra las características de Anthos y proporciona acceso a la supervisión y la visibilidad de la carga de trabajo.
Una herramienta de línea de comandos de actl que ayuda a instalar el modo privado de Anthos y realizar otras tareas administrativas.

Diagrama que describe la arquitectura del modo privado de Anthos

^{Figura: figura de arquitectura del modo privado de Anthos}

Después de leer este documento, consulta Instala el Centro de administración de Anthos para obtener detalles completos sobre la instalación de un entorno de modo privado de Anthos.

Prepare el entorno

Requisitos previos

Antes de seguir las instrucciones de este documento, asegúrate de cumplir con los requisitos técnicos del modo privado de Anthos.

Obtén acceso al modo privado de Anthos

Necesitamos otorgar acceso a las actualizaciones del modo privado de Anthos. Proporciona tu punto de contacto de Google con una dirección de correo electrónico para cada verificador para que podamos otorgarle acceso al repositorio de descargas. Estas direcciones de correo electrónico deben ser Cuentas de Google.

Una vez que tu punto de contacto de Google confirme que tienes acceso a las actualizaciones del modo privado de Anthos, verifica que tengas los permisos para descargar las actualizaciones del modo privado de Anthos mediante la ejecución del siguiente comando: gsutil ls gs://anthos-private-mode-release/

Si obtienes un error, ejecuta el comando gcloud auth list para verificar que gsutil use la misma Cuenta de Google que proporcionaste a tu punto de contacto de Google.

También puedes visitar el bucket de actualización más reciente para verificar que tienes los permisos correctos. Debes acceder con la Cuenta de Google que proporcionaste antes.

Si tienes problemas para acceder a las actualizaciones del modo privado de Anthos, comunícate con tu punto de contacto de Google para obtener ayuda.

Descarga el modo privado de Anthos

En esta sección, debes descargar la versión del modo privado de Anthos, que se encuentra en varios archivos de varios gigabytes cada uno. Según tu conexión a Internet, es posible que la descarga demore mucho tiempo.

Descarga el modo privado de Anthos

En tu estación de trabajo de administrador, ejecuta los siguientes comandos:

# Login with the account granted access to Anthos private mode
gcloud auth login

# Download the script which helps download all the latest components
export VERSION=0.9.0-gke.1
gsutil cp gs://anthos-private-mode-release/$VERSION/get-anthos-private-mode.sh .
chmod +x get-anthos-private-mode.sh
./get-anthos-private-mode.sh

# If you are working on a workstation shared with other users,
# we recommend that you revoke your credentials after downloading the release.
gcloud auth revoke [YOUR_EMAIL]

Instala las dependencias restantes

Una vez completada la descarga del modo privado de Anthos, ejecuta los siguientes comandos:

cd anthos-baremetal-private-mode

# Add actl command line tool and bin directory to the PATH
export PATH=$PWD/bin:$PATH

# Download Harbor offline installer
curl -SL \
  https://github.com/goharbor/harbor/releases/download/v2.2.0/harbor-offline-installer-v2.2.0.tgz \
  --output "local-registry/harbor-offline-installer.tgz"

# Install docker-compose
curl -SL \
  https://github.com/docker/compose/releases/download/1.28.5/docker-compose-Linux-x86_64 \
  --output "local-registry/docker-compose"

Estos son los dos únicos pasos del proceso que requieren una conexión a Internet. Si instalas el modo privado de Anthos en un entorno que está completamente aislado de Internet, puedes realizar una de las siguientes acciones:

Primero, conecta tu estación de trabajo de administrador a Internet y descarga la actualización como se muestra arriba. Luego, desconecta la estación de trabajo de Internet y conéctala al entorno a prueba.
Descarga la versión de una estación de trabajo para desarrolladores conectada a Internet, cópialo en un dispositivo de almacenamiento portátil y mueve este dispositivo de almacenamiento portátil a tu estación de trabajo de administrador, ideal.

Puedes explorar el contenido del lanzamiento del modo privado de Anthos:

./anthos-baremetal-private-mode
├── baremetal
│   ├── images
│   └── package-spec.yaml
├── bin
│   ├── actl
│   ├── istioctl
│   └── nomos
├── bmctl-workspace
│   └── admin
│       └── admin.yaml
├── local-registry
│   ├── cleanup.sh
│   ├── docker-compose
│   ├── generate-certs.sh
│   ├── harbor-offline-installer.tgz
│   └── install.sh
├── managementcenter
│   ├── images
│   └── management-center.yaml
├── services
│   ├── anthos-config-management
│   ├── anthos-service-mesh
│   └── images
├── third_party
└── updatecenter
    └── images

El directorio local-registry contiene los recursos para configurar un registro de contenedores local.
Otros directorios como managementcenter, services y baremetal contienen todo lo necesario para instalar el clúster de administrador y el centro de administración del modo privado de Anthos.

Habilita la opción de autocompletado de la shell actl [Opcional]

actl admite la función de autocompletado de shell para Bash, Zsh y Fish. Para configurar la finalización en tu shell, sigue las instrucciones en actl help completion, por ejemplo, en Ubuntu/Debian, Bash:

# One time setup: install bash-completion
sudo apt update && sudo apt install bash-completion

# In ~/.bashrc
source /etc/profile.d/bash_completion.sh
source <(actl completion bash)

Configura tu Container Registry

El modo privado de Anthos funciona mediante el almacenamiento de las imágenes de contenedor de Anthos en un registro de contenedores local. Puedes usar tu propio registro de contenedores existente o usar el registro de contenedores en modo privado de Anthos.

Exporta las siguientes variables de entorno.

export REGISTRY_IP=[YOUR_REGISTRY_IP]
export REGISTRY_PASSWORD=[YOUR_REGISTRY_PASSWORD]

# By default, a "library" public project is created,
# and you can also create other private projects via the Harbor portal.
export PRIVATE_REGISTRY=${REGISTRY_IP}/library

Aquí:

[YOUR_REGISTRY_IP] es la dirección IP de tu registro. Si deseas instalar y usar el registro de contenedores del modo privado de Anthos en la estación de trabajo de administrador, usa aquí la dirección IP de tu estación de trabajo de administrador.
[YOUR_REGISTRY_PASSWORD] es la contraseña de tu registro existente o una contraseña nueva si creas un registro de contenedores nuevo.

Si decides usar tu propio registro de contenedores, ve a la sección Sube imágenes al registro de contenedores.

Configura el registro de contenedores del modo privado de Anthos

En esta sección, configurarás un registro de contenedores privado en la estación de trabajo de administrador. Ejecuta todos los comandos que aparecen a continuación desde la estación de trabajo de administrador.

Si no tienes un registro de contenedores privado, instala el registro de contenedores en modo privado de Anthos.

cd ~/anthos-baremetal-private-mode

# Move it to a path under $PATH
chmod a+x local-registry/docker-compose
sudo cp local-registry/docker-compose /usr/bin

# Install local registry
./local-registry/install.sh

Notas:

El registro de contenedores del modo privado de Anthos se usa solo para instalar el modo privado de Anthos. Todavía no está listo para su uso en producción.
El proyecto de registro público predeterminado es library y se puede usar de forma predeterminada. Sin embargo, puedes acceder al registro y crear un proyecto nuevo, si así lo deseas.
Container Registry está disponible en https://${REGISTRY_IP}/. Las credenciales de acceso son el nombre de usuario admin y ${REGISTRY_PASSWORD} para la contraseña.
Las credenciales se almacenan sin encriptar en /home/<USER>/.docker/config.json.

Accede al registro para verificar que tienes acceso. Es posible que debas esperar unos segundos si recibes un error.

docker login ${REGISTRY_IP} -u admin -p ${REGISTRY_PASSWORD}

Sube imágenes a Container Registry

En esta sección, subirás las imágenes de contenedor en modo privado de Anthos a tu registro de contenedores.

Prepara y sube las imágenes de contenedor en modo privado de Anthos a tu registro de contenedores. Si se te solicita, elige la opción Use that credential.
```
actl images push --private-registry=${PRIVATE_REGISTRY} \
    --images ~/anthos-baremetal-private-mode
```