Commit 57cb58f9 authored by GOMEZ GALLEGOS MARIA CONCEPCION's avatar GOMEZ GALLEGOS MARIA CONCEPCION
Browse files

Update README.md

parent 6aec9a29
......@@ -52,47 +52,46 @@ El archivo pesa alrededor de 500MB por lo que demora un poco en descargarse.
# Instalación de Docker
### En Windows
1. Una vez que se descargue el instalador de Docker, procedemos a su instalación haciendo doble clic sobre el archivo descargado para que inicie el asistente de instalación.
#### 1. Una vez que se descargue el instalador de Docker, procedemos a su instalación haciendo doble clic sobre el archivo descargado para que inicie el asistente de instalación.
2. Se abrirá una ventana de instalación de Docker.\
#### 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")\
3. Establecer todas las configuraciones por defecto o recomendadadas por el asistente de instalación, dar clic en el botón Ok.\
#### 3. 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.\
#### 4. Continuará con la instalación.\
![Instalacion](images-project/Inst_Window3.png "Instalacion")\
5. Finalizar instalación.\
#### 5. Finalizar instalación.\
Dar clic en close and restart.\
![Close](images-project/Inst_Window4.png "Close")\
El asistente de instalación pedirá reiniciar el equipo al finalizar la instalación.\
Se creará un icono en el escritorio de Windows, dar clic en el icono de Docker.
### En Ubuntu
1. Actualizar repositorios con el comando:\
#### 1. Actualizar repositorios con el comando:\
**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**\
![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:\
#### 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")\
3. Agregar la clave GPG para el repositorio oficial de Docker a su sistema:\
#### 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")\
4. Agregar el positorio de Docker a las fuentes de apt:\
#### 4. Agregar el positorio 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")\
5. Actualizar la base de datos de paquetes usando los paquetes de Docker del repositorio que se acaba de Agregar:\
#### 5. Actualizar la base de datos de paquetes usando los paquetes de Docker del repositorio que se acaba de Agregar:\
**sudo apt update**
6. Instalar Docker:\
#### 6. Instalar Docker:\
**sudo apt install docker-ce**\
![Instalar_docker](images-project/Inst_Ubuntu6.png "Instalar docker")\
7. Verificar que se esté ejecutando:\
#### 7. Verificar que se esté ejecutando:\
**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:\
......@@ -102,10 +101,10 @@ Para agregar su nombre de usuario al grupo docker y así evitar escribir sudo an
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")\
8. Para probar que todo funciona correctamente, ejecutar el siguiente comando para obtener información de Docker en su sistema:\
#### 8. Para 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")\
9. Instalación de una utilería de Docker para hacer usar correctamente el Geocubo Portable. Ejecutar el siguiente comando:\
#### 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")\
# Ejecutar el software en nuestro equipo
......@@ -154,11 +153,24 @@ Nota: El cuaderno puede ser modificado para descargar otras regiones del país.
# Solución a posibles errores
A continuación, se listan posibles errores que pueden ocurrir durante el proceso de instalación de este manual y cual es su posible solución:
1. No se reconoce el comando **“docker”** en el sistema.
### 1. No se reconoce el comando **“docker”** en el sistema.
- Puede deberse a que no se ha iniciado docker correctamente. Docker inicia con el sistema, se convierte en uno de los programas de arranque, si llegará a ocurrir este error puede deberse a que aún no ha iniciado y haya que esperar unos cuantos segundos más. Podemos corroborar que docker ha iniciado desde la barra de tareas.
- En caso de que ya haya pasado más de 2 minutos y docker no inició, buscamos Docker en la barra de búsqueda de Windows e iniciamos manualmente el software.
2. Al momento de ejecutar el **“docker-compose up –build”**, aparece el error “no such service: --build”.
a. Puede deberse a que los guiones medios que se utilizaron en este manual pueden no corresponder al verdadero código ascii del guion que espera la terminal o consola de Power Shell. Para solucionarlo borre los guiones medios del comando y reescríbalos usted mismo desde la consola.
3. Durante la instalación del GeoCubo Portable nos llegan a aparecer los siguientes mensajes en el “Dashboard” de docker:\
### 2. Al momento de ejecutar el **“docker-compose up –build”**, aparece el error “no such service: --build”.
- Puede deberse a que los guiones medios que se utilizaron en este manual pueden no corresponder al verdadero código ascii del guion que espera la terminal o consola de Power Shell. Para solucionarlo borre los guiones medios del comando y reescríbalos usted mismo desde la consola.
### 3. Durante la instalación del GeoCubo Portable nos llegan a aparecer los siguientes mensajes en el “Dashboard” de docker:\
En Windows:\
En Ubuntu:
![Error](images-project/Error1.png "Error")\
En Ubuntu:\
![Error](images-project/Error2.png "Error")\
- Es necesario descargar un archivo zip del siguiente enlace. El archivo zip contiene 3 archivos “.sh” que deben ser sustituidos de la ruta: “../datacube-inegi-on-docker/database-cubito/init/”.\
Enlace de los archivos:\
https://365inegi-my.sharepoint.com/:u:/g/personal/armando_soto_inegi_org_mx/EUCDJvuGzT1IthITNvd7uZgBMY6ciD8eY0dUwcSKPAOtnA?e=D0Q4Sg
- En caso de sustituir los archivos y aún continuar con problemas, favor de contactar a los creadores del proyecto.
### 4. En caso de obtener un error como el que se muestra en la imagen:\
![Error](images-project/Error3.png "Error")\
El error es:\
ERROR: for datacube-inegi-on-docker_datacube_db_1 Cannot create container for service datacube_db: status code not OK but 500:\
- Para solucionarlo, es necesario abrir el dashboard de docker, haciendo clic derecho sobre el icono de docker en la barra de tareas. Hacer clic en el engrane de la parte superior para modificar las configuraciones; seleccionar la opción de Resources y seleccionar la subopción File Sharing. Dentro de esa opción, en la parte derecha de la venta tenemos que seleccionar el botón con el “+” y seleccionamos la carpeta “C:/”. Y por ultimo, hacemos clic en el botón “Apply & Restart”.\
![Error](images-project/Error4.png "Error")
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