Esta entrada forma parte de una serie de post publicados.
Vamos a utilizar:
- Git para el control de versiones
- GitHub para almacenar los ficheros en la nube y usarlos para el despliegue contínuo
- Visual Studio Code como editor de nuestros archivos:
- HTML
- JS
- Algunos complementos para VSCode:
- marcamos el 'Auto Save' para la grabación contínua de archivos
- HTML Snippets para mejorar las sugerencias de etiquetas en HTML
- Live Server para hacer un despliegue contínuo en nuestro local host
- Netlify para desplegar la página web
Paso Cero
- Sacamos una cuenta de GitHub si no la tenemos.
- Instalamos el software de control de versiones Git en nuestro PC (Windows, Linux, Mac). Mirar a ver si ya lo tenemos instalado, y en caso afirmativo mirar a ver si lo tenemos actualizado.
- Instalamos Visual Studio Code
- Sacamos una cuenta de Netlify.
Paso Uno
- Creamos un nuevo repositorio en nuestra cuenta de GiHub. En nuestro caso le hemos llamado JS_improve
- Copiamos la URL del repositorio
- Abrimos una terminal en la carpeta Documentos (Documents)
- En Windows se puede ir al Exploarador de archivos, ir a la carpeta Documentos y luego poner arriba cmd. Al pulsar Enter se nos abrirá la terminal en el directorio Documents.
- En Linux podemos ir a Files, ir a la carpeta elegida y pulsando con el botón derecho del ratón veremos la opción 'Open in Terminal'.
- En cualquier caso podemos abrir una terminal e ir a la carpeta deseada
- Clonamos el repositorio con el comando
donde la url debe ser la de vuestro repositorio.git clone https://github.com/financieras/JS_improve.git
- Si queremos, podemos ver que se han creado los mismos archivos que en el repositorio de GitHub más un archivo oculto
.git
- Abrir VSCode. También se puede abrir estando en la terminal, en la carpeta deseada y tecleando
y al pulsar Enter se abrirá el editor de código.code .
Paso Dos
- Estamos en VSCode y vamos a crear un nuevo archivo denominado index.html
- Lo primero que escribimos en nuestro nuevo archivo es
html:5
y al pulsar Enter veremos ya un código básico para nuestro fichero html. Es el siguiente.<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Document</title> </head> <body> </body> </html>
- Ahora podemos crear ya nuestro código del archivo index.html en su primera versión funcional, que es el siguiente.
<!DOCTYPE html> <html lang="es"> <head> <meta charset="UTF-8"> <script src="./calcula.js"></script> <title>Calculadora en JavaScript</title> </head> <body> <h1>Calculadora en JavaScript</h1> <h2>Variables de entrada</h2> <p>Primer número: </p> <input type="number" value="2" id="n1"> <p>Segundo número: </p> <input type="number" value="5" id="n2"> <p>Pulse el botón para sumar.</p> <input type="button" value="Sumar" onclick="sumar()"> <h2>Resultado</h2> <p id="total"></p> </body> </html>
- Ahora vamos a crear nuestro archivo calcula.js
function sumar(){ let uno=document.getElementById("n1"); let dos=document.getElementById("n2"); let myTotal=document.getElementById("total"); let laSuma=parseInt(uno.value) + parseInt(dos.value); myTotal.innerText="El resultado es: "+ laSuma; }
Paso Tres
- Dividimos la pantalla en dos partes, a la izquierda ponemos el VSCode y a la derecha nuestro navegador por defecto.
- Estando en VSCode veremos abajo un icono que pone 'Go Live'. Este existe debido a que previamente hemos instalado el complemento 'Live Server'. Pulsamos con el ratón sobre 'Go Live' y veremos que en el navegador se abre nuestra página de Local Host. En mi caso uso el puerto 5500 y cualquiera de estas dos páginas funcionará
- http://127.0.0.1:5500/index.html
- http://localhost:5500/index.html
- Si todo ha ido bien veremos nuestra aplicación funcionando. También podemos ver en el navegador la ayuda para desarrolladores pulsando F12, en Chrome y otros navegadores.
Paso Cuatro
- Ahora vamos a subir los cambios a GitHub. Podemos usar la terminal integrada en Visual Studio Code.
- Abrimos la terminal desde el propio Visual Studio Code con Terminal / New Terminal
- En mi caso operando desde Ubuntu tengo la terminal que se ve en la siguiente imagen.
- Veamos cómo subir los cambios desde la terminal con comandos de Git.
git add --all
git commit -m "Primera version funcional"
git push
- Ahora comprobamos en GitHub que se han subido bien los cambios. Recargamos la página de GitHub y vemos que los cambios son recientes.
git status
podemos comprobar si nuestra copia local está actualizada y sin cambios respecto a la copia en la nube.Paso Cinco
- Vamos a utilizar GitHub Pages para conseguir que nuestra página web se vea en internet y no solo en nuestro Local Host.
- Vamos a nuestro repositorio y en el menú superior pulsamos sobre 'Settings', el icono es una rueda dentada.
- En el menú vertical elegimos 'Pages'.
- En la rama elegimos 'main' y en la carpeta elegimos 'root'.
- Pulsamos sobre el botón 'Save'.
- Ya tenemos página web desplegada en GitHub Pages. Nos informan con un mensaje que primero es azul y luego verde cuando ya es operativa. Puede tardar unos minutos en ponerse verde.
- El resultado obtenido ya es funcional y tiene su propia página web.
https://financieras.github.io/JS_improve
Paso nueve
- Vamos a desplegar la página web creada en Netlify.
- En mi caso ya tengo otro proyecto corriendo en Netlyfy pero podemos crear uno nuevo pulsando en el botón denominada 'New Site from Git'.
- Creamos un nuevo sitio con despliegue contínuo utilizando los archivos que tenemos subidos a un repositorio de GitHub.
- Tenemos que indicar a Netlify el nombre del repositorio de GitHub que deseamos desplegar. Para ello tenemos que configurar Netlify con GitHub: 'Configure Netlify on GitHub'.
- Nos muestra una lista con la cuenta y las organizaciones asociadas a esa cuenta. Elegiremos aquella en la que está el repositorio que deseamos desplegar.
- Damos acceso a todos los repositorios de esa cuenta o bien a uno concreto. En mi caso, he elegido 'All repositories'.
- Elegimos el repositorio deseado.
- Vemos abajo, en verde, que aparece la palabra 'Published', que nos indica que ya está publicada nuestra página web. El despliegue ya se ha producido. La dirección web (url) que nos han asignado aparece arriba y tiene un nombre que no es amigable, ni sencillo de recordar, pero puede ser cambiado.
- Vemos que la página está desplegada en nuestra extraña url.
- Vamos a cambiar el nombre de la url por uno más amigable, pulsando 'Change site name'.
- Ahora vemos que nuestra web está desplegada en https://calculadoraprima.netlify.app
Paso once
- Vamos a añadir un archivo css para los estilos. El archivo se denominará
style.css
.body { background-color: LightCyan; font-size: 24px; } #resultH2{ color: blue; }
- El archivo
index.html
también requiere un par de cambios, la fila donde llamamos al archivo css y al final hemos añadido la etiquetaresultH2
.
<!DOCTYPE html> <html lang="es"> <head> <meta charset="UTF-8"> <link rel="stylesheet" href="./style.css"> <script src="./calcula.js"></script> <title>Calculadora en JavaScript</title> </head> <body> <h1>Calculadora en JavaScript</h1> <h2>Variables de entrada</h2> <p>Primer número: </p> <input type="number" value="2" id="n1"> <p>Segundo número: </p> <input type="number" value="5" id="n2"> <p>Pulse el botón para sumar.</p> <input type="button" value="Sumar" onclick="sumar()"> <h2 id="resultH2">Resultado</h2> <p id="total"></p> </body> </html>
- Podemos ver el resultado en nuestro Local Host.
- Subimos los cambios a GitHub usando comandos de consola.
- git add --all
- git commit -m "incluimos estilos css"
- git push
- Miramos los cambios en GitHub Pages https://financieras.github.io/JS_improve
- Miramos los cambios en Netlify https://calculadoraprima.netlify.app
Gracias la despliegue contínuo hemos conseguido que los cambios realizados de forma local en nuestro ordenador se suban, haciendo el push en git, tanto a GitHub Pages como a Netlify.
¡Una maravilla, esto del despliegue contínuo!
No hay comentarios:
Publicar un comentario