Este artículo se actualizó por última vez el 2021-01-22, el contenido puede estar desactualizado.
¡Hola a todos!
En esta guía les voy a explicar como instalar la herramienta Okit Designer Tookit para diseñar nuestros propios diagramas de Oracle Cloud Infrastructure.
Okit Designer
OCI designer toolKIT (OKIT) es un conjunto de herramientas que permiten diseñar, desplegar y visualizar ambientes de OCI a través de una interfaz web, lo que permite a arquitectos y diseñadores cloud contruir una representación visual de su infraestructura y luego exportarla en los siguientes formatos:
svg
png
jpeg
Una vez que se haya completado el diseño, este se puede exportar a las siguientes herramientas:
Ansible
Terraform
OCI Resource Manager
Esto acelera el despliegue de una infraestructura completa en OCI.
Hay dos maneras de instalar Okit Designer: con Vagrant y Docker. En esta oportunidad lo vamos a hacer por Docker y Docker Compose para aislarlo de nuestro sistema.
Instalando Prerrequisitos
Fedora 33
Antes de instalar Docker, vamos a actualizar nuestro sistema:
1
sudo dnf update -y
En caso que se haya actualizado a un nuevo kernel, reiniciamos el sistema:
Abrimos el instalador con permisos de administrador y seguimos los pasos:
Abriendo InstaladorFinalizando instalación
Ahora, vamos a configurar para que WSL v2 sea la versión por defecto en nuestro sistema. Para ello debemos abrir una ventana de PoweShell como Administrador (yo uso la versión 7 que puedes descargar aquí) y colocamos el siguiente comando:
1
wsl--set-default-version2
Ya con esto terminamos de configurar WSL en nuestro sistema.
Ejecutamos el instalador con permisos de Administrador y vamos a instalar con las opciones por defecto:
LicenciaDirectorio Destino, lo dejamos en la ubicación predeterminadaSeleccionamos los componentes a instalar, dejaremos los que estan por defectoIconos del Menú InicioDejamos por defecto o podemos cambiar el editor de textos predeterminadoDejamos la opción recomendadaDejamos el ejecutable de ssh que viene con el instalador, en caso de tener ya instalado putty, podemos escoger la segunda opciónDejamos por defecto a OpenSSL para emitir certificados X509SiguienteSiguienteSiguienteSiguienteSiguienteInstalarFinalizando instalación
Vamos al CMD de Windows o PowerShell y verificamos la versión de Git instalada:
1
2
3
4
5
6
7
Microsoft Windows [Versión 10.0.19041.423]
(c) 2020 Microsoft Corporation. Todos los derechos reservados.
C:\Users\usuario>git --versiongit version 2.28.0.windows.1
C:\Users\usuario>
Ejecutamos el instalador con permisos de Administrador y vamos a instalar con las opciones por defecto:
Dejamos habilitadas ambas opciones, activar WSL v2 y que coloque un acceso directo en el escritorioInstalandoReiniciamos el sistema nuevamenteUna vez reiniciamos, lo veremos en la barra de tareas
Instalando Okit Designer
Clonamos el repositorio de Okit
Clonamos el repositorio oficial de Okit Designer (la versión actual es la 0.9.2):
Creando archivo de configuración de Okit y la llave ssh para conectarnos a la API de OCI
Si no tenemos instalado y configurado la oci-cli (explicado en este POST), debemos crear un archivo de configuración que contendrá el id de la cuenta, además de la llave SSH para poder acceder a la API y desplegar lo que ya hayamos diseñado:
Creamos el directorio containers/oci dentro del directorio raíz (oci-designer-toolkit) ;
Fedora 33:
1
2
mkdir /home/usuario/oci-designer-toolkit/containers/oci
cd /home/usuario/oci-designer-toolkit/containers/oci
Generamos la llave ssh, colocando la ubicación donde queremos guardar el archivo y el formato .pem (En Windows podemos dejarla en la ubicación predeterminada (directorio .ssh en la carpeta home del usuario) y luego copiarla a nuestra carpeta containers\oci):
Generating public/private rsa key pair.
Enter file in which to save the key (/home/usuario/.ssh/id_rsa): /home/usuario/oci-designer-toolkit/containers/oci/oci_api_key.pem
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/usuario/oci-designer-toolkit/containers/oci/oci_api_key.pem
Your public key has been saved in /home/usuario/oci-designer-toolkit/containers/oci/oci_api_key.pem.pub
The key fingerprint is:
SHA256:Dg4RrcxIYUREOcvrEKZ7mL8ZcqRnmkibkXDOQVhZelE usuario@localhost.localdomain
The key's randomart image is:
+---[RSA 4096]----+
| =O=+oE |
| +=. o. |
|.oo*o. |
|.o+.+. |
|+.+.. . S |
|+*o. o o |
|oXB . . |
|*B*o |
|+=+. |
+----[SHA256]-----+
Creamos el archivo de configuración en /home/usuario/oci-designer-toolkit/containers/oci/config, con su editor de textos de confianza:
Fedora 33:
1
vim /home/usuario/oci-designer-toolkit/containers/oci/config
En Windows 10 Pro, abrimos un Notepad y vamos a escribir los siguientes parámetros:
key_file es la ubicación donde está almacenada la llave privada ssh (la guardamos en /home/usuario/oci-designer-toolkit/containers/oci/oci_api_key.pem)
tenancy es el identificador OCID de tu cuenta
region es la región por defecto donde despliegues la infraestructura
Ahora, ¿De donde sacamos toda esta información? En las siguientes imagenes lo vamos a ver.
Colocamos el nombre de nuestra CuentaIniciamos sesión en la página de OCI.Vamos al icono de Perfil y hacemos click en nuestro usuario registrado.Copiamos nuestra OCID de usuario y la colocamos en el parámetro user.Vamos a la opción Tenancy.Copiamos nuestra OCID de la cuenta y la colocamos en el parámetro tenancy.Vamos de nuevo a la pantalla usuarios, opción API Keys, y agregamos una nueva.Arrastramos solo la LLAVE PÚBLICA, y click en Add.Copiamos el fingerprint, y lo pegamos en el parámetro fingerprint.
Vamos al directorio y ejecutamos docker-compose para descargar las imagenes y contruir el contenedor:
Fedora 33:
1
2
cd /home/usuario/oci-designer-toolkit/containers/docker
docker-compose up
Buy me a coffee