devs/README.md

# AMBIENTE LOCAL PARA DESARROLLADORES (MRDEVS TOOLS)
## GUÍA PARA DESARROLLADORES - REV. 08/12/2024

### PREPARACIÓN DE AMBIENTE LOCAL PARA DESARROLLADORES

#### Creación del área local de trabajo para desarrolladores

En la carpeta $HOME descargue el repositorio devs (la carpeta no debe existir):

    $ cd $HOME
    $ git clone https://git.rosero.one/mrosero/devs.git

**Nota:** Previamente, debe tener instalado el comando git.

#### Instalación de herramientas básicas y de gestión de contenedores 

A partir de este momento, la carpeta $HOME/devs será nuestra área de desarrollo donde se descargaran los diversos ambientes de desarrollo. Como primer paso instalaremos las herramientas básicas y de gestión de contenedores. Por razones de seguridad, priorizamos el uso de **podman**.

    $ cd $HOME/devs
    $ bin/bootstrap.sh

#### Actualización de ambiente local de desarrollo

Actualice los nuevos cambios y funcionalidades del ambiente de desarrollo local raíz

    $ cd $HOME/devs
    $ bin/update.sh

### ACCESO VPN A INFRAESTRUCTURA PARA DESARROLLADORES

#### Instalación de Cliente VPN con ambiente GUI (gráfico)

Para tener acceso a todos los recursos y servidores de desarrollo se requiere acceder vía VPN a la infraestructura d desarrollo. Para esto, se requiere instalar el cliente PRITUNL como sigue:

    $ cd $HOME/devs
    $ bin/vpn_install.sh [--help] [--version] [--update]

Nota: En determinadas versiones, las actualizaciones a partir de los repositorios no es posible por lo que usamos el argumento --update.

#### Instalación de Cliente OpenVPN con ambiente TUI (texto)

(pendiente)

#### Obtener archivo de configuración para acceso VPN

(pendiente)

### GESTIONANDO PERIFL DE DESARROLLADOR

#### Configuración por defecto de comportamineto GPG

En la carpeta **$HOME/devs/bin/config** existe un archivo de configuración **gpg.config** que contiene los parámetros de comportamiento por defecto para **[GNUGP](https://gnupg.org/)** que son los recomendados para el uso de la plataforma. Si tienes alguno en uso, está función le sacará previamente una copia y aplicará el de la plataforma siguiendo los siguientes pasos:

    $ cd $HOME/devs
    $ bin/gpg_init.sh

#### Copia de básica del perfil del desarrollador

Para realizar una copia de seguridad de sus configuraciones de desarrollador que involucran claves GPG, claves SSH, configuración GIT y otros, ejecute los siguientes comandos:

    $ cd $HOME/devs
    $ bin/gpg_backup.sh
[IMPROVED] bootstrap.sh - Instalar herramientas base y podman 2024-12-08 05:11:04 +00:00			`# AMBIENTE LOCAL PARA DESARROLLADORES (MRDEVS TOOLS)`
[IMPROVED] update.sh -- Permite actualizar el ambiente de desarrollo desde el repo 2024-12-08 21:53:08 +00:00			`## GUÍA PARA DESARROLLADORES - REV. 08/12/2024`
Initial commit 2024-12-08 04:06:42 +00:00
[IMPROVED] bootstrap.sh - Instalar herramientas base y podman 2024-12-08 05:11:04 +00:00			`### PREPARACIÓN DE AMBIENTE LOCAL PARA DESARROLLADORES`

			`#### Creación del área local de trabajo para desarrolladores`

			`En la carpeta $HOME descargue el repositorio devs (la carpeta no debe existir):`

			`$ cd $HOME`
			`$ git clone https://git.rosero.one/mrosero/devs.git`

[DOCS] Actualización de la documentación 2024-12-08 22:14:06 +00:00			`Nota: Previamente, debe tener instalado el comando git.`

[IMPROVED] update.sh -- Permite actualizar el ambiente de desarrollo desde el repo 2024-12-08 21:53:08 +00:00			`#### Instalación de herramientas básicas y de gestión de contenedores`
[IMPROVED] bootstrap.sh - Instalar herramientas base y podman 2024-12-08 05:11:04 +00:00
			`A partir de este momento, la carpeta $HOME/devs será nuestra área de desarrollo donde se descargaran los diversos ambientes de desarrollo. Como primer paso instalaremos las herramientas básicas y de gestión de contenedores. Por razones de seguridad, priorizamos el uso de podman.`

			`$ cd $HOME/devs`
			`$ bin/bootstrap.sh`
[IMPROVED] Instalación de Mozilla SOPS 2024-12-08 21:03:25 +00:00
[IMPROVED] update.sh -- Permite actualizar el ambiente de desarrollo desde el repo 2024-12-08 21:53:08 +00:00			`#### Actualización de ambiente local de desarrollo`
[IMPROVED] Instalación de Mozilla SOPS 2024-12-08 21:03:25 +00:00
[IMPROVED] update.sh -- Permite actualizar el ambiente de desarrollo desde el repo 2024-12-08 21:53:08 +00:00			`Actualice los nuevos cambios y funcionalidades del ambiente de desarrollo local raíz`
[IMPROVED] Instalación de Mozilla SOPS 2024-12-08 21:03:25 +00:00
[IMPROVED] update.sh -- Permite actualizar el ambiente de desarrollo desde el repo 2024-12-08 21:53:08 +00:00			`$ cd $HOME/devs`
			`$ bin/update.sh`
[IMPROVED] Instalación de Mozilla SOPS 2024-12-08 21:03:25 +00:00
[DOCS] Actualización de la documentación 2024-12-08 22:14:06 +00:00			`### ACCESO VPN A INFRAESTRUCTURA PARA DESARROLLADORES`

			`#### Instalación de Cliente VPN con ambiente GUI (gráfico)`

			`Para tener acceso a todos los recursos y servidores de desarrollo se requiere acceder vía VPN a la infraestructura d desarrollo. Para esto, se requiere instalar el cliente PRITUNL como sigue:`

[DOCS] Actualización a la documentación 2024-12-09 16:05:24 +00:00			`$ cd $HOME/devs`
			`$ bin/vpn_install.sh [--help] [--version] [--update]`

			`Nota: En determinadas versiones, las actualizaciones a partir de los repositorios no es posible por lo que usamos el argumento --update.`
[DOCS] Correcciones menores a la documentación 2024-12-14 22:30:49 +00:00
[DOCS] Actualización a la documentación 2024-12-09 16:05:24 +00:00			`#### Instalación de Cliente OpenVPN con ambiente TUI (texto)`

			`(pendiente)`

			`#### Obtener archivo de configuración para acceso VPN`
[DOCS] Actualización de la documentación 2024-12-08 22:14:06 +00:00
[DOCS] Actualización a la documentación 2024-12-09 16:05:24 +00:00			`(pendiente)`
[DOCS] Actualización de la documentación 2024-12-08 22:14:06 +00:00
[MODIFIED] Cambio para manejo de perfil de desarrollador - Se cambia la libreria gpg a developers - Se cambia el comando gpg_backup.sh a profile_backup.sh - Se hacen mejoras a la documentación del sistema - El respaldo ahora incluye las carpetas .ssh, .gnugp y .gitconfig del usuario - Otros cambios menores 2024-12-14 21:20:43 +00:00			`### GESTIONANDO PERIFL DE DESARROLLADOR`
[IMPROVED] gpg_init.sh - (Re)inicialización de configuración GPG 2024-12-09 18:43:45 +00:00
[MODIFIED] Cambio para manejo de perfil de desarrollador - Se cambia la libreria gpg a developers - Se cambia el comando gpg_backup.sh a profile_backup.sh - Se hacen mejoras a la documentación del sistema - El respaldo ahora incluye las carpetas .ssh, .gnugp y .gitconfig del usuario - Otros cambios menores 2024-12-14 21:20:43 +00:00			`#### Configuración por defecto de comportamineto GPG`
[IMPROVED] gpg_init.sh - (Re)inicialización de configuración GPG 2024-12-09 18:43:45 +00:00
[DOCS] Correcciones menores a la documentación 2024-12-14 22:30:49 +00:00			`En la carpeta $HOME/devs/bin/config existe un archivo de configuración gpg.config que contiene los parámetros de comportamiento por defecto para [GNUGP](https://gnupg.org/) que son los recomendados para el uso de la plataforma. Si tienes alguno en uso, está función le sacará previamente una copia y aplicará el de la plataforma siguiendo los siguientes pasos:`
[IMPROVED] gpg_init.sh - (Re)inicialización de configuración GPG 2024-12-09 18:43:45 +00:00
			`$ cd $HOME/devs`
			`$ bin/gpg_init.sh`

[MODIFIED] Cambio para manejo de perfil de desarrollador - Se cambia la libreria gpg a developers - Se cambia el comando gpg_backup.sh a profile_backup.sh - Se hacen mejoras a la documentación del sistema - El respaldo ahora incluye las carpetas .ssh, .gnugp y .gitconfig del usuario - Otros cambios menores 2024-12-14 21:20:43 +00:00			`#### Copia de básica del perfil del desarrollador`
[DOCS] Se agrega documentación sobre backup de gpg 2024-12-13 05:37:12 +00:00
[DOCS] Correcciones menores a la documentación 2024-12-14 22:30:49 +00:00			`Para realizar una copia de seguridad de sus configuraciones de desarrollador que involucran claves GPG, claves SSH, configuración GIT y otros, ejecute los siguientes comandos:`
[DOCS] Se agrega documentación sobre backup de gpg 2024-12-13 05:37:12 +00:00
			`$ cd $HOME/devs`
			`$ bin/gpg_backup.sh`