Commit 4ce2bd6c authored by GOMEZ GALLEGOS MARIA CONCEPCION's avatar GOMEZ GALLEGOS MARIA CONCEPCION
Browse files

Update README.md

parent 65b44dd9
......@@ -68,14 +68,15 @@ Una vez que se descargue el instalador de Docker, se procede a su instalación h
#### 2. Se abrirá una ventana de instalación de Docker.
Comenzará a descargar los archivos necesarios para la instalación.\
![Descarga](images-project/Inst_Window1.png "Descarga")\
![Descarga](images-project/Inst_Window1.png "Descarga")
#### 3. Configuración
Establecer todas las configuraciones por defecto o recomendadadas por el asistente de instalación, dar clic en el botón Ok.\
![Configuracion](images-project/Inst_Window2.PNG "Configuracion")
#### 4. Continuará con la instalación.
Descomprimir archivos.\
![Instalacion](images-project/Inst_Window3.png "Instalacion")\
![Instalacion](images-project/Inst_Window3.png "Instalacion")
#### 5. Finalizar instalación.
Dar clic en close and restart.\
......@@ -85,84 +86,100 @@ Se creará un icono en el escritorio de Windows, dar clic en el icono de Docker.
#### 6. Probar Docker.
Para probar Docker, abrir una ventana de Windows Powershell y se ejecuta el siguiente comando:\
**docker info**
`docker info`
## En Ubuntu
#### 1. Actualizar repositorios con el comando:
**sudo apt update**\
`sudo apt update`\
\
![Actualizar_repositorios](images-project/Inst_Ubuntu1.png "Actualizar repositorios")\
Nota: Si el comando le pide que se actualicen paquetes del sistema operativo será necesario ejecutar el siguiente comando:\
**sudo apt-get upgrade**\
`sudo apt-get upgrade`\
\
![Actualizar_paquetes](images-project/Inst_Ubuntu1a.png "Actualizar paquetes")\
Enseguida volver a ejecutar el comando update.
#### 2. Instalar algunos paquetes que permiten a apt usar paquetes mediante https:
**sudo apt install apt-transport-https ca-certificates curl software-properties-common**
![Instalar_paquetes](images-project/Inst_Ubuntu2.png "Instalar paquetes")\
`sudo apt install apt-transport-https ca-certificates curl software-properties-common`\
\
![Instalar_paquetes](images-project/Inst_Ubuntu2.png "Instalar paquetes")
#### 3. Agregar la clave GPG para el repositorio oficial de Docker a su sistema:
**curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –**
![Agregar_clave](images-project/Inst_Ubuntu3.png "Agregar clave")\
`curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –`\
\
![Agregar_clave](images-project/Inst_Ubuntu3.png "Agregar clave")
#### 4. Agregar el repositorio de Docker a las fuentes de apt:
**sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"**
![Agregar_repositorio](images-project/Inst_Ubuntu4.png "Agregar repositorio")\
`sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"`
\
\
![Agregar_repositorio](images-project/Inst_Ubuntu4.png "Agregar repositorio")
#### 5. Actualizar la base de datos de paquetes usando los paquetes de Docker del repositorio que se acaba de Agregar:
**sudo apt update**
`sudo apt update`
#### 6. Instalar Docker:
**sudo apt install docker-ce**\
![Instalar_docker](images-project/Inst_Ubuntu6.png "Instalar docker")\
`sudo apt install docker-ce`\
\
![Instalar_docker](images-project/Inst_Ubuntu6.png "Instalar docker")
#### 7. Verificar que se esté ejecutando:
**sudo systemctl status docker**\
`sudo systemctl status docker`\
\
![Verificiar_docker](images-project/Inst_Ubuntu7.png "Verificar docker")\
De forma predeterminada, el comando docker solo se puede ejecutar por el usuario de root o por un usuario perteneciente al grupo docker, el cual se creó durante la instalación de Docker. Si intenta ejecutar el comando docker sin el prefijo sudo o sin estar en el grupo docker, en la consola se mostrará un mensaje como el siguiente:\
docker: Cannot connect to the Docker daemon. Is the docker daemon running on this host?. See 'docker run --help'.\
Para agregar su nombre de usuario al grupo docker y así evitar escribir sudo antes ejecutar el comando docker, ejecute lo siguiente:\
**sudo usermod -aG docker ${USER}**\
`sudo usermod -aG docker ${USER}`\
\
Para aplicar la nueva membresía de grupo, debe cerrar sesión en el servidor y volver a iniciarla, o puede ejecutar lo siguiente:\
**su - ${USER}**\
![Membresia_grupo](images-project/Inst_Ubuntu7a.png "Membresia grupo")\
`su - ${USER}`\
\
![Membresia_grupo](images-project/Inst_Ubuntu7a.png "Membresia grupo")
#### 8. Probar que todo funciona correctamente.
Ejecutar el siguiente comando para obtener información de Docker en su sistema:\
**docker info**\
![Informacion](images-project/Inst_Ubuntu8.png "Informacion")\
`docker info`\
\
![Informacion](images-project/Inst_Ubuntu8.png "Informacion")
#### 9. Instalación de una utilería de Docker para hacer usar correctamente el Geocubo Portable.
Ejecutar el siguiente comando:\
**sudo apt install docker-compose**\
![Utileria_docker](images-project/Inst_Ubuntu9.png "Utileria docker")\
`sudo apt install docker-compose`\
\
![Utileria_docker](images-project/Inst_Ubuntu9.png "Utileria docker")
# Ejecutar el software en nuestro equipo
El Geocubo portable requerie el uso de contenedores y microservicios que se ejecutan a través de la consola de comandos PowerShell.\
Añadir la imagen al repositorio de nuestro Docker local que es la imagen de docker que se descargó desde el inicio de este manual, que tiene un tamaño aproximado de 4GB. Dicha imagen contiene la instalación de todas las librerías que se requieren para el correcto funcionamiento del Geocubo Portable.
#### 1. Abrir una terminal en Linux o una consola de Windows Power Shell.
#### 2. Colocarse en la ubicación donde se descargó la imagen:
**cd .\Documents**
Colocarse, desde la consola, en la ubicación de la imagen que recién descargamos. Para ello puede utilizar el comando: cd /ruta/donde/se/encuentre/el/archivo. Si usted almacenó la imagen en la carpeta de Documentos, como se sugirió al inicio, puede utilizar el siguiente comando:\
`cd .\Documents\`
#### 3. Añadir la imagen con el siguiente comando:
**docker load -i .\CubitoDatos.tar**\
`docker load -i .\CubitoDatos.tar`\
Este paso puede tardar algunos minutos, pero una vez que termine se puede ver que se agregó a la lista de imágenes en docker a través del siguiente comando:\
**docker image ls**\
![Imagen_load](images-project/Imagen_load.png "Imagen añadida")\
`docker image ls`\
\
![Imagen_load](images-project/Imagen_load.png "Imagen añadida")
#### 4. Verificar el archivo docker-compose.yml.
Para continuar con el proceso de instalación del GeoCubo Portable, es necesario revisar y en su caso modificar el archivo docker-compose.yml que se encuentra en la raíz del proyecto que se descargó de gitlab previamente. Las líneas a revisar se encuentran señaladas en la siguiente imagen:\
![Archivo](images-project/Archivo_yml.png "Archivo")\
Nota: Si estas en el sistema operativo de Windows y la carpeta Almacenamiento la tienes ubicada en C:/, la raíz del sistema, no es necesario que hagas ninguna modificación en el archivo antes mencionado y puedes continuar con el siguiente paso, resaltado en negritas en la siguiente pagina.
#### 5. Moverse a la ubicación del proyecto:
cd '.\Documents\datacube-inegi-on-docker\'\
`cd '.\Documents\datacube-inegi-on-docker\'`\
En caso de que recién ejecutarás Power Shell, si continuas con la misma ventana con la que cargaste la imagen de docker es con el siguiente comando:\
cd 'datacube-inegi-on-docker\'
`cd 'datacube-inegi-on-docker\'`
#### 6. Crear/Iniciar los contenedores.
Activar e iniciar tareas de los contenedores de Docker con el siguiente comando:
**docker-compose up -d**\
Activar e iniciar tareas de los contenedores de Docker con el siguiente comando:\
`docker-compose up -d`\
\
![Activar_contenedores](images-project/Docker_compuse.png "Activar contenedores")\
Una vez que se haya ejecutado el comando los contenedores de Docker para el Geocubo Portable estarán activos e iniciando sus tareas, se podrán monitorear desde el Dashboard.
#### Detener los contenedores.
Instrucción para detener contenedores:\
**docker-compose stop**
Instrucción para detener contenedores:\
`docker-compose stop`
# Iniciar un cuaderno de Jupyter
Es una herramienta que nos permite ejecutar un código en Python al mismo tiempo que se va explicando.
#### 1. Iniciar contenedor.
Si el contenedor con el Geocubo Portable ya se encuentra disponible en su equipo, pero no se está ejecutando, es necesario que desde una terminal en Linux o una consola de Power Shell de Windows, se ubiquen en la raíz del proyecto de gitlab y se ejecute el siguiente comando:\
**docker-compose up –d**\
`docker-compose up –d`\
\
-d es importante porque manda el proceso a segundo plano, indica que la base de datos está iniciada y el datacube está iniciado. Podemos salirnos o cerrar la consola y el Geocubo se está ejecutando.
#### 2. Iniciar cuaderno de Jupyter.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment