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 FIRMA GPG

#### Inicialización de configuración GPG

Como un requisito de nuestra plataforma, todos los desarrolladores deberán contar, por lo menos, con una clave GPG, que se utilizará para firmar o decifrar archivos, correos u otros.  Esto se hará con el uso del comando gpg (previamente instalado con la ejecución de bin/boostrap.sh).

En este paso estableceremos la configuración por defecto de GPG:

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

#### Creación de clave GPG
[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.`

			`#### 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
[IMPROVED] gpg_init.sh - (Re)inicialización de configuración GPG 2024-12-09 18:43:45 +00:00			`### GESTIONANDO FIRMA GPG`

			`#### Inicialización de configuración GPG`

[IMPROVED] Copia de Seguridad local de claves GPG 2024-12-13 04:48:09 +00:00			`Como un requisito de nuestra plataforma, todos los desarrolladores deberán contar, por lo menos, con una clave GPG, que se utilizará para firmar o decifrar archivos, correos u otros. Esto se hará con el uso del comando gpg (previamente instalado con la ejecución de bin/boostrap.sh).`
[IMPROVED] gpg_init.sh - (Re)inicialización de configuración GPG 2024-12-09 18:43:45 +00:00
			`En este paso estableceremos la configuración por defecto de GPG:`

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

			`#### Creación de clave GPG`