README.md 7.21 KB
Newer Older
SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
1
2
# Geocubo Portable

SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
3
4
Este proyecto permite a un usuario realizar diferentes tipos de análisis geoestadísticos, a través de programación en Python, sobre diferentes zonas de estudio. El proyecto hace uso de los productos generados por el CDGM de INEGI.

5
6
Es una versión compacta del Cubo de Datos Geoespacial de INEGI; pues en su base de datos solo hace referencia a los archivos de Geomedianas de los años de 1993 a 2019, es decir, que todas las consultar que se hagan desde el Geocubo Portable serán resueltas a partir de las Geomedianas indexadas en él.

SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
7
# Prerequisitos de instalación
8
9
10
11
    1. Sistema operativo Windows 10 Pro o Ubuntu 18+.
    2. Procesador de 4 núcleos.
    3. 8GB de memoria RAM.
    4. 100 GB de almacenamiento disponible. La cantidad puede variar dependiendo de la cantidad de imágenes que se desee analizar, cada Geomediana nacional pesa alrededor de 35 GB y el total de espacio que ocupan todas las geomedianas es de 1 TB.
SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
12

13
14
15
# Recursos necesarios
## Estructura de archivos
El Geocubo Portable requiere de una estructura de archivos para su correcto funcionamiento.
16
#### Enlace para descargar estructura de archivos:
17
18
19

https://365inegi-my.sharepoint.com/:u:/g/personal/armando_soto_inegi_org_mx/EYI6vT513DNJlLijteyR1M4B0RiVnDvKH_FMeub_mZXIIA?e=ydgtYu

20
El archivo que se descarga se llama **“Almacenamiento.zip”** y se suguiere que sea descompactado en la raíz de alguna unidad de almacenamiento (C:/, D:/, para el caso de Windows; /home/user/, para el caso de Ubuntu) de manera que sea más fácil hacer referencia a él más adelante.
21

22
23
24
25
La carpeta de Almacenamiento contiene dos subcarpetas.

![Almacenamiento](images-project/Almacenamiento.PNG "Carpeta Almacenamiento")

26
27
## Proyecto en gitlab
Otro elemento necesario para instalar el Cubito de datos es el proyecto de geocubo-portable publicado en el gitlab institucional de INEGI. Se recomienda clonarlo con Git para tener las actualizaciones más recientes, sin embargo, basta con descargarlo.
28
29
Descargar el proyecto en formato **ZIP** y se sugiere sea almacenado y descompactado en la carpeta de “Documentos”.

30
![Descarga](images-project/Descargar_proyecto.png "Descargar prooyecto")
31
32
33

## Imagen de Docker con el Geocubo Portable
El último elemento que se necesita es la imagen de docker que contiene todo el software necesario para el correcto funcionamiento del Geocubo Portable.
34
#### Enlace para descargar la imagen de Docker
35
36
37

https://drive.google.com/file/d/1oXSHo2mvRJW4043qwd9z9z-4ZC1873jK/view?usp=sharing

38
Este archivo tiene un formato **TAR** y un tamaño mayor a los 4 GB, por lo que su descarga puede demorar varios minutos, se sugiere sea almacenado en la carpeta de “Documentos” para facilitar su acceso más adelante.
39

40
41
## Docker
Tecnología para la creación y uso de contenedores de linux; permite crear diferentes ambientes de trabajo para la ejecución de aplicaciones.
SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
42

43
44
45
46
Descargar el instalador **Docker Desktop Installer.exe** la versión estable más actual.
#### Enlace para descargar

https://hub.docker.com/editions/community/docker-ce-desktop-windows
SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
47

48
49
![Descargar_docker](images-project/Descarga_docker.png "Descargar docker")

50
51
El archivo pesa alrededor de 500MB por lo que demora un poco en descargarse.

52
53
# Instalación 
### En Windows
54
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.
55

56
57
58
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")\
59

60
61
62
63
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.\
![Instalacion](images-project/Inst_Window3.png "Instalacion")\
64

65
66
67
68
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.\
69
70
71
72
Se creará un icono en el escritorio de Windows, dar clic en el icono de Docker.


### En Ubuntu
73
74
1. Actualizar repositorios con el comando:\
**sudo apt update**\
75
![Actualizar_repositorios](images-project/Inst_Ubuntu1.png "Actualizar repositorios")\
76
77
Nota: Si el comando le pide que se actualicen paquetes del sistema operativo será necesario ejecutar el siguiente comando:\
**sudo apt-get upgrade**\
78
![Actualizar_paquetes](images-project/Inst_Ubuntu1a.png "Actualizar paquetes")\
79
80
Enseguida volver a ejecutar el comando update
2. Instalar algunos paquetes que permiten a apt usar paquetes mediante https:\
81
**sudo apt install apt-transport-https ca-certificates curl software-properties-common**
82
![Instalar_paquetes](images-project/Inst_Ubuntu2.png "Instalar paquetes")\
83
3. Agregar la clave GPG para el repositorio oficial de Docker a su sistema:\
84
**curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –**
85
![Agregar_clave](images-project/Inst_Ubuntu3.png "Agregar clave")\
86
4. Agregar el positorio de Docker a las fuentes de apt:\
87
**sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"**
88
![Agregar_repositorio](images-project/Inst_Ubuntu4.png "Agregar repositorio")\
89
5. Actualizar la base de datos de paquetes usando los paquetes de Docker del repositorio que se acaba de Agregar:\
90
**sudo apt update**
91
6. Instalar Docker:\
92
93
**sudo apt install docker-ce**\
![Instalar_docker](images-project/Inst_Ubuntu6.png "Instalar docker")\
94
95
7. Verificar que se esté ejecutando:\
**sudo systemctl status docker**\
96
![Verificiar_docker](images-project/Inst_Ubuntu7.png "Verificar docker")\
97
98
99
100
101
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}**\
Para aplicar la nueva membresía de grupo, debe cerrar sesión en el servidor y volver a iniciarla, o puede ejecutar lo siguiente:\
102
103
**su - ${USER}**\
![Membresia_grupo](images-project/Inst_Ubuntu7a.png "Membresia grupo")\
104
8. Para probar que todo funciona correctamente, ejecutar el siguiente comando para obtener información de Docker en su sistema:\
105
106
107
108
109
**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")\
110
111
# 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.
SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
112
# Iniciar un cuaderno de Jupyter
113
Es una herramienta que nos permite ejecutar un código en Python al mismo tiempo que se va explicando.
SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
114

SOTO VALDEZ ARMANDO's avatar
SOTO VALDEZ ARMANDO committed
115
# Solución a posibles errores