El git flow establece una forma de trabajo dentro de un proyecto de desarrollo, en el cual existen diversas ramas que se unen de manera tal que el trabajo fluye de manera ágil dentro de un equipo de desarrollo.
Las ramas son las siguientes:
Master: están tabulado y conlleva las versiones que saldrán en producción.
Develop = donde se establece la combinación de trabjos desarrollados por los diversas ramas.
Release = cuando un trabajo de la rama develop está ya suficientemente maduro se pasa a esta rama con el fin de que luego salga a producción.
Feature = estas ramas representan las diversas funciones que están en desarrollo yu que una vez finalizadas se agregaran a la rama develop.
Hotfix = contiene los arreglos que hay que realizarles a la rama master ára resolver problemas inesperados, estos deben luego pasarse a la master y tambien al develop.
Aunque existe git flow para window , en el presente artículo lo trabajaremos a mano como trabajar con este protodolo. los objetivos serán los siguientes:
I.- Crear un repositorio local simple, y uno remoto y conectarlos.
II.- Hacer un tag de la rama master
III.- Crear desde la rama master una rama develop donde en el cual se realizará un nuevo proyecto en django.
IV.- Crear ramas features a partir de la rama develop contengan las funciones (app) para el proyecto.
V.- Incorporar las ramas features en la rama develop.
VI.- Crear la rama release a partir de la rama develop.
VII .- Incorporar la rama release a la rama master colocando una nueva etiqueta a la master.
VIII.- Crear una rama Hotfix a partir de la rama master, donde se coloque un parche.
IX.- Colocar los arreglos del hotfix en la rama master y develop resolviemdo los conflictos que diere lugar.
I.- Crear un repositorio local simple, y uno remoto y conectarlos.
1.- Abre una cuenta en git hud diferente a tu usuario y asúmero como si fuera el usuario de la empresa.
2.- Haz click en repositorio .
3.- Haz click en nuevo repositorio.
4.- Da nombre del proyecto al repositorio.
5.- Escoge privado.
6.- Escribe la descipción.
7.- Elige la opción privado
8.- Haz click en crear repositorio.
ahora deberás ir a la carpeta donde tines el proyeto creado y:
9.- Abrir una consola de git bash en esta carpeta con el nombre del proyecto , para ello debes dar click derecho y escoger la opción git bash here. y abrirá la terminal de git.
9.a . coloca cualquier documento .py en la carpeta.
10.- coloca el comando
git init
y se creará un nuevo repositorio de git en una carpeta oculta, para mirar esta crapeta pues colocar el comando
ls -a
11.- solo como paso anexo, puedes ver el estado del repositorio con el comando
git status
12.- Añade los archivos al repostitorio con el comando
git add .
que lo añade a staged
13.- Ahora puedes realizar el commit con el comando
este lo debes pegar en la consola de git que estás trabajando y dar enter, con ello consigue la unión remota del repositorio local con el que creaste en git hud.
15.- Por último utliza el comando:
git push -u origin master
nota si al descragar git elegiste usar el nomber main el comando a usar será :
git push -u origin main
16.- Ahora sólo actualiza el repositorio y si todo marchó bien ya debes tener el repositorio en tu empresa privado
en el video sigiuoente explica más detalladamente:
II.- Hacer un tag de la rama master
1.-Abre una consola git bash en la carpeta donde está el proyecto.
2.- Coloca el siguiente comando:
git tag v 0.1 -m "versión inicial"
el comando creará una etiqueta para el proyecto inicial. a la rama master.
III.- Crear desde la rama master una rama develop donde en el cual se realizará un nuevo proyecto en django.
1.- Abre una consola git bash en la carpeta donde está el proyecto.
2.- Desde la rama master coloca el siguiente comando y da enter.
git ckeckout -b develop
el comando creará una nueva rama llamada develop
puedes colocra el comando
git branch
para que muestre las diversas ramas y em la rama que te encuentras.
puedes usar el comando
git ckeckout nombre_de_la_rama
para pasear entre las diversas ramas
3.- Ahora en la carpeta abre una ventana de el visual studio code.
4.- Activa tu entorno virtual donde tienes descargado django.
5.- Abre una terminal en el editor (es importante que sea CMD, sino deseas lidear con algunos problemas).
6.- Escribe los comandos
django-admin startproject mysite
mysite es el nombre de tu proyecto. al darle enter formará un nuevo proyecto django.
7.- en la página principal crea el git ignore para dejando y visaul estudio code.
8.- Ahora vuelve a la consola de git bash y estándo en la rama develop coloca los siguientes comandos:
git add .
git commit -m "comienzo de proyecto en develop"
puedes usar el comando
git status
para saber que el proceso se realizó con éxito.
ahora utiliza el comando:
git push -u origin develop
para enviar esta rama a el repositorio remoto.
IV.- Crear ramas feature a partir de la rama develop contengan las funciones (app) para el proyecto.
Supondremos necesitamos el modulo de registro,
1.- Debes abrir nuevamente el git bash en el proyeto ubicarte en la rama develop con el comando:
git checkout develop
y ahora colocar el comando
git pull
para traer las actualizaciones en la web.
ahora colocarás los comandos
git branch feature_registro
git checkout featutre_registro
2.- Ahora irás a la terminal del visual studio y colocarás el comando:
python manage.py startapp registro
y se creará una nueva app en el proyecto con el nombre registro.
3.- Ahora en el git bash deberás guardar los cambios desde la rama feature_registro con:
git add .
git commit -m "inicio del app registro"
4.- Ahora debés hacer el push:
git push -u origin feature_registro.
V.- Incorporar las ramas features en la rama develop.
Ahora supondremos que ya se han terminado la app, y debemos pasarlas a la rama develop.
1.- Haz el pull desde la web con git pull desde la consola de git bash.
2.- Estando en la rama develop coloca el siguiente comando
git merge featutre_registro develop
3.- luego coloca
git add .
git commit - m " merge de feature_registro con develop"
git push
VI.- Crear la rama release a partir de la rama develop.
IV.- Realizar un repositorio en Git Hud subir el proyecto creado en Djando al repositorio.
En primer lugar supondremos que usted es el dueños de una empresa de desarrollo y que tiene en git hud con esa empresa una cuenta en git hud. por otro lado también entenderemos que usted tendrá una cuenta como desarrollador aparte de la cuenta empresarial, y ustede será su propio empleado.
I.- Crea tu primer proyecto en django.
1.- Debes ubicarte en la carpeta base de ti proyecto, teniendo activado
el entorno virtual desde visual studioi code.
2.- Abre una nueva terminal, utiliza mejor el CMD.
3.- Utiliza el comando
django-admin startproject mysite
nota: mysite es el nombre del proyecto que deseas empezar.
haz enter y se crea ya un proyecto en esa carpeta. con la siguiente forma:
en la página: https://docs.djangoproject.com/es/4.1/intro/tutorial01/
explica daca uno de estos documentos.
4.- ahora corre el servidor interno de django con el comando:
debes ir a el proyectyo creado con el comando cdhasta llegar a mysite. y desde allí colocar el comando:
python manage.py runserver
5.- Por último visita http://127.0.0.1:8000/ y verás tu proyecto corriendo.
ejemplo en sel siguiente video:
II.- Establecer la carpeta de requerimiento del proyecto.
Es importante para la documentación de un proyecto django listart las dependencias necesarias, y hacerlo desde el principios es elemental para ellos e debe usar en la terminal del proyecto el comando:
pip freeze > requirements.txt
se pulsa enter , y ya es todo, esto creará el archivo requerinetms.txt en la base del proyecto.si luego se desea usar esto para instalar en otro coputador se debe:
pip install -r requirements.txt
y se descragará en ese nuevo entorno virtual los requerimientos.
el video siguiente aplica más detenidamente el apartado anterior:
III.- Colocar un gitignore:
1.- habra un nuevo terminal de git en la carpeta del proyecto y coloque el siguiente
comando:
touch .gitignore
este comando creará una archivo .gitignore dentro de su archivo.
2.- Ahora visite el protal
https://www.toptal.com/developers/gitignore/
y cree un archivo git ignore colocando en el imput las palabras django, el editor
que use en mi caso Visual estudiop code.
3.- haga click en crear y le generará un archivo.
4.- copie el archivo y peguelo en el git ignore creado en su proyecto. a este archivo podrá agregar cualquier otro que necesite.
IV.- Realizar un repositorio en Git Hud de la empresa donde trabajas, y subir el proyecto creado a este repositorio.
1.- Abre una cuenta en git hud diferente a tu usuario y asúmero como si fuera el usuario de la empresa.
2.- Haz click en repositorio .
3.- Haz click en nuevo repositorio.
4.- Da nombre al repositorio
5.- Escoge privado
6.- escribe la descipción.
7.- Elige la opción privado
8.- Haz click en crear repositorio.
ahora deberás ir a la carpeta donde tines el proyeto creado y:
9.- Abrir una consola de git bash en esta carpeta , para ello debes dar click derecho y escoger la opción git bash here. y abrirá la terminal de git.
10.- coloca el comando
git init
y se creará un nuevo repositorio de git en una carpeta oculta, para mirar esta crapeta pues colocar el comando
ls -a
11.- solo como paso anexo, puedes ver el estado del repositorio con el comando
git status
12.- Añade los archivos al repostitorio con el comando
git add .
que lo añade a staged
13.- Ahora puedes realizar el commit con el comando
este lo debes pegar en la consola de git que estás trabajando y dar enter, con ello consigue la unión remota del repositorio local con el que creaste en git hud.
15.- por último utliza el comando:
git push -u origin master
nota si al descragar git elegiste usar el nomber main el comando a usar será :
git push -u origin main
16.- Ahora sólo actualiza el repositorio y si todo marchó bien ya debes tener el repositorio en tu empresa privado
en el video sigiuoente explica más detalladamente:
A continuación se presenta un resumen de los preparativos que se debe hacer para iniciar un proyecto con django, el artículo incluye el resumen seguido por un video donde se detalla más el proceso.
Al final de este artículo usted podrá:
I.- Instalar Python.
II.- Descargar visual studio code.
III.- Descargar y configurar git para window.
IV.- Crear Entorno virtual de trabajo en Python y activarlo
V.- Descargar django.
VI.- Crea tu primer proyecto en django.
I.- Intalación de Python:
1.-visita la página :
2.-https://www.python.org/downloads/
3.- haz click en descarga.
4.-Ahora instala python tomando en cuenta que en le proceso debes seleccionar incorporar python al paht.
5.- entra al CMD y coloca el comando:
python --version
nota: se debe mostrar en pantalla del terminal la versión de python que se ha instalado.
II.- Descargar visual studio code.
1.-visite la página:
https://code.visualstudio.com/download
2.-haga click en descargar la versión que necesite.
Haz click en el instalador que se ha descargado e instala tomando en cuenta marcar las opciones que se use habrá un ícono en escritorio, que se puedan abrir carpetas y documentos con code.
En el suguiente video te muestra el detalle de los dos apartado anteriores:
III.-Descargar y configurar git para window
Instalar git
1.- Ingrese a la siguiente página:
https://git-scm.com/downloads}
2.- Haga click en descargar
3.- Haz click en el instalador que se ha descargado e instala tomando en cuenta configurar para visual estudio code ( si es este editor que usarás)
Detalles en el siguiente video:
4.- abro una consola de git bath y coloco:
git --version
y muestra la versión de git
Configurar git para window y Git hud
Abrá una consola del git bath
coloque los siguientes comando para configurar git
git config – global user.name “ mi nombre”
use el nombre de su git hud
git config – global user.email mi email
coloque el email de su git Hud
git config --global core.editor “code –wait”
establece como editor predeterminado a visual estudio code
Si estoy en
window debo usar la siguiente configuración:
git config --global
core.autocrlf true
git config --list --global
muestra la lista de configuraciones
en el siguiente video se muestran detalles:
IV.-Crear entorno virtual en python y activarlo.
1.- Ingresa en el CMD de la computadora:
2.- Ahora descarga el creador de ientorno virtual con el comando:
pip install virtualenv
3.-Coloca el comando
pip freeze
para saber la lista de los modulos de python instados.
4.- Crea una nueva carpeta donde deseas crear el entorno virtual:
5.- Dirigete a esa carpeta y abre en ella una nueva terminal de cmd,
nota: esto se hace lendo a donde está la dirección borrando todo y colocando CMD y dándole a enter.
6.- En esta nueva carpeta coloque el comando:
virtualenv nombre_corto_emntornovirtual
Nota: nombre_corto_emntornovirtual representa el nombre que deseas colocarle al entorno virtual que crearás.
7.- Ahora en el CMD y el comando cd ingresas al entorno virtual con los siguientes comandos:
cd nombre_corto_emntornovirtual
cd Scripts
cd actavate
Nota: para desactivar el entorno virtual se sigue el mismo procedimiento pero en vez de activatre se debe colocra desactivate.
Los detalles de este apartado se muestran en el siguiente video:
V.- Descargar django y crear tu primer proyecto.
Visite la página :
https://www.djangoproject.com/download/
allí encontrará los comandos para activar la última versión , claro está tambien en esa págona encontrarás como descargar versiones anteriores, por ejemplo al día de hoy la versión más es:
pip install Django==4.1.7
Para utilizar este comando:
1.- Crea una nueba carpeta donde realizarás el proyecto.
2.- Abre la crapeta creada en visual estudio code.
3.- abre una nueva terminal (usa la opción del cmad, que es ma´s compatible con django que el power shell).
4.- En la terminal activa el entorno virtual que ya tienes crado.
5.- coloca el comando de la página obtenido de la https://www.djangoproject.com/download/ en la terminal y haz click en enter.
6.- Coloca el comando
pip freeze
o puedes usar el comando
python -m django --version
en el siguiente video se muestra los detalles:
VI.- Crea tu primer proyecto en django.
1.- Debes ubicarte en la carpeta base de ti proyecto, teniendo activado
el entorno virtual desde visual studioi code.
2.- Abre una nueva terminal, utiliza mejor el CMD.
3.- Utiliza el comando
django-admin startproject mysite
nota: mysite es el nombre del proyecto que deseas empezar.
haz enter y se crea ya un proyecto en esa carpeta. con la siguiente forma:
en la página: https://docs.djangoproject.com/es/4.1/intro/tutorial01/
explica daca uno de estos documentos.
4.- ahora corre el servidor interno de django con el comando:
debes ir a el proyectyo creado con el comando cdhasta llegar a mysite. y desde allí colocar el comando:
python manage.py runserver
5.- Por último visita http://127.0.0.1:8000/ y verás tu proyecto corriendo.
ejemplo en sel siguiente video:
VII.- Establecer la carpeta de requerimiento del proyecto.
Es importante para la documentación de un proyecto django listart las dependencias necesarias, y hacerlo desde el principios es elemental para ellos e debe usar en la terminal del proyecto el comando:
pip freeze > requirements.txt
se da enter , y ya es todo, esto creará el archivo requerinetms.txt en la base del proyecto.si luego se desea usar esto para instalar en otro coputador se debe:
pip install -r requirements.txt
y se descragará en ese nuevo entorno virtual los requerimientos.
el video siguiente aplica más detenidamente el apartado anterior:
