Skip to content

Latest commit

 

History

History
502 lines (381 loc) · 15.7 KB

README.md

File metadata and controls

502 lines (381 loc) · 15.7 KB
Raw

Curso de Deploy con Now.sh

Tabla de Contenido

Componentes de una aplicación

Actualmente una aplicación "moderna" esta compuesta por varias partes (algunas aplicaciones tienen más que otras), las cuales son:

  • Archivos estáticos o Frontend: Estos archivos no cambian y son enviados al usuario por medio de un CDN. Estos archivos pueden ser imágenes, js, css, fuentes, audios. videos, etc.
  • Backend for Frontend: Servidor que pide datos al API y responde HTML al usuario.
  • Backend API: Puede estar hecho en cualquier tecnología e incluso puede estar dividido en múltiples aplicaciones pequeñas encargadas de distintas responsabilidades cada una. El API se comunica con la base de datos.
  • Bases de datos (DB): Es donde se almacena los datos de la aplicación. Puede ser cualquier base de datos e incluso puede ser más de una.

Definiciones importantes:

  • CDN = Content Delivering Network. Muchos servidores distribuidos por todo el mundo proveer de estos archivos comunes y que no están generados dinámicamente a nuestros usuarios y que puedan acceder rápidamente a ellos.
  • API = Aplication Programming Interface. Representa la capacidad de comunicación entre componentes de software.

Flujo de una Aplicación Web

Flujo de una Aplicación Web

¿Cómo es el flujo de un usuario en una aplicación?

  1. El usuario accede al backend for frontend.
  2. El backend for frontend le pide los datos al backend API.
  3. el backend API va a leer los datos de la base de datos.
  4. La base de datos le va a dar la respuesta de su query.
  5. El backend API va a parsear los datos en un json.
  6. El backend API envía el json al frontend.
  7. El frontend genera con el json el HTML.
  8. El frontend envía el HTML al usuario.
  9. El usuario va a descargar los estáticos de frontend.
  10. El usuario recibe el css, js, imágenes, etc.
  11. Con el js descargado, el usuario puede iniciar una aplicación del lado de cliente.
  12. El js se puede conectar directamente con el backend API e interactuar directamente sin pasar por el backend for frontend.

Opciones para hacer deploy

  • Amazon Web Services: Es el más grande de todas las opciones para hacer deploy.
  • Microsoft Azure: Es muy buenas para deploys con MS SQL y C#.
  • Google Cloud Platform: Tiene un montón de servicios. Una ventaja es que tiene varias API propias de Google que se pueden integrar en la aplicación.
  • Heroku: permite hacer deploy sin tener que pensar en cómo va a funcionar al app por debajo ni la infraestructura de esta.
  • Digital Ocean: permite tener un servidor privado y empezar a encontrar todo lo que se quiere ahí.
  • GitHub Pages: Permite hacer el deploy de archivos estáticos. Es completamente gratis pero el código es open source.
  • Surge.sh: Permite hacer deploys estáticos muy fácilmente por medio de un CLI.
  • Zeit Now: Es una plataforma para hacer deploy de todo tipo de aplicaciones. No permite hacer deploy de base de datos.

Opciones de Deploy

Control de la infraestructura se referiere a poder controlar cómo funciona la aplicación por debajo:

  • ¿Cuántos servidores hay?
  • ¿Qué tipo de servidores son?
  • ¿Qué hardware tienen?

¿Por qué Zeit Now?

Tipos de deploy:

  • Aplicación de Node.js
  • Sitios estáticos
  • Contenedores de Docker

Deploy fáciles:

  • Con un comando: now
  • con un drag & drop con el cliente.

Características:

  • Es fácil. Todo se hace con un solo comando.
  • Escala automáticamente. Se crean instancias dependiendo del tráfico de la aplicación.
  • Deploy inmutable. Cada deploy genera una url única.
  • Deploy sin caída. Al escalar automáticamente y generar una nueva url en cada deploy, se puede asegurar la continuidad de la aplicación.
  • Deploy ilimitados.
  • HTTP2 automáticamente.
  • Certificado SSL gratis.
  • Logs por deploy.
  • DNS (zeit.world).
  • Permite comprar dominios por CLI.

Aplicaciones monolíticas vs microservicios

Monolítico vs Microservicios

Aplicaciones monolíticas

Todo el código está en una solo aplicación.

Ventajas:

  • Buena para aplicaciones pequeñas.
  • Fácil de desarrollar.
  • Fácil de hacer deploy.
  • Fácil para trabajar individual o en equipos pequeños.

Desventajas:

  • Difícil de mantener a largo plazo.
  • Costosa para escalar.
  • En caso de un error se puede caer toda la aplicación.
  • Más difícil testear.
  • Más difícil de depurar.

Microservicios

El código está dividido en varias aplicaciones.

Ventajas:

  • Fácil de hacer deploy.
  • Fácil de escalar.
  • Fácil de testear.
  • Fácil de depurar.
  • En caso de error, solo se cae un servicio.
  • Se pueden utilizar diferentes tecnologías.

Desventajas:

  • Difícil de orquestar.
  • Puede ser lenta la comunicación entre servicios.
  • Difícil saber cómo dividir nuestra aplicación.
  • Es más costoso de mantener.

Cuando se usa microservicios, se tiende a hacer servicios de terceros que realicen parte de la aplicación.

Servicios de Terceros

Orquestación y Coreografía de Servicios

Ambos conceptos se basan en cómo hacer para comunicar nuestros servicios y que todo funcione como si fuera una sola aplicación.

Orquestación: El servicio ‘A’ manda peticiones HTTP avisando que ya terminó su tarea. El código de peticiones del servicio ‘A’ depende de la cantidad de servicios a los que deba avisar que terminó su tarea.

Coreografía: Servicio general de suscripciones a canales. Los servicios ajenos al servicio ‘A’ van a estar (o no) a la escucha de la finalización de la tarea del servicio ‘A’. No hace falta modificar el código del servicio ‘A’, ya que al agregar un nuevo servicio se pondría éste a la escucha de la finalización de la tarea del servicio ‘A’.

Instalación de Now

$ npm install -g now

Deploy de aplicaciones estáticas

Github Pages

Github Pages se usa mucho para documentar librerías.

  1. Settings
  2. Ir a la sección Github Pages.
  3. En source marcar master branch.
  4. Clic a save.
  5. Si la barra está en un color rojo tenue, significa que aún está en proceso.
  6. Cuando la barrita está en verde significa que está hecho el deploy.

Surge

Para usar Surge, primero se debe de instalar:

npm install -g surge

Luego vas a la carpeta del proyecto con la consola.

Escribes el comando surge.

Now

  1. Ir a la capeta del proyecto
  2. Escribir el comando now.

Si se desea cambiar la url generada se puede hacer de la siguiente manera:

now alias URL_AUTOGENERADA alias.now.sh

Deploy a Node.js

Para hacer deploy a una aplicación en node.js, hay que crear un archivo now.json.

En ese eschivo, escribir lo siguiente:

{
  "name": "platzi-now-bff",
  "type": "npm"
}

Deploy de contenedores de Docker

  • pubsub = Nos sirve para tener una forma de comunicarnos cuando hacemos la parte de las suscripciones en real time.
  • resolvers = Nos sirven para saber qué hacer en cada query o cada cambio que el navegador envía al API.
  • squema = Le escribimos todo el esquema de datos que tiene nuestra aplicación, los datos que existen.
  • server = Donde inicializamos el servidor, sincronizamos el modelo con la base de datos, creamos el servidor express y creamos todo lo que necesitamos para correr en producción.
{
  "name": "platzi-now-api",
  "type": "docker"
}

Variables de Entorno

Para crear variables de enterno, se añade un key env en el archivo now.json.

{
  "name": "platzi-now-bff",
  "env": {
    "NODE_ENV": "production",
    "PORT": "3000",
    "HOST": "0.0.0.0",
    "DB_USER": "cobliwpv",
    "DB_PASS": "",
    "DB_HOST": "stampy.db.elephantsql.com",
    "DB_NAME": "cobliwpv",
    "DB_PORT": "5432"
  },
  "type": "docker"
}

Secrets

En ocasiones, se necesita almacenar información confidencial del proyecto que solo debe ser accedida con el código en ejecución. Esto puede lograrse usando secrets.

Una vez que almacena un secreto, sus contenidos ya no son accesibles directamente por nadie. Solo pueden estar expuestos a implementaciones como variables de entorno.

  • now secret add [key] [valor] Permite agregar un nuevo secrets.
  • now secret rename [key] [valor] Permite renombrar un secrets.
  • now secret rm [key] [valor] Permite eliminar un secrets.
  • now secret ls Permite listar todos los secrets.

Para usar los secrets en el archivo now.json, se hace de la siguiente manera:

{
  "env": {
    "DB_USER": "@platzi_now_db_user",
    "DB_PASS": "@platzi_now_db_pass"
  }
}

Ver el Código Fuente

Para ver el código fuente del proyecto, solo hay que poner /_src al final de la url de now.

https://podcast-dadzjorpfe.now.sh/_src
  • En el plan free de now, el código fuente es open source.
  • En el plan premium, hay que estar logueado para poder ver el codigo fuente.

Definir Aliases

Para definir un alias dentro de nuestro pyoyecto, lo podemos hacer desde nuestro archivo now.json:

{
  "alias": "platzi-now-api.now.sh"
}

Para ejecutar el alias, se debe ir a la carpeta del proyecto y escribir now alias.

Cuando utilizamos now alias, se va a tomar el último deploy que se hizo y va a conectarlo al alias que hayamos creado.

Dominio Personalizado

Zeit.world es un DNS gratiuto global que Zeit nos da para manejar los dominios.

Si ya se tiene un dominio:

  1. Ir a la configuración de Nameservers del dominio.
  2. Escoger Custom DNS
  3. Agregar unos de los hostnames que aparecen en la página de Zeit World. Se pueden agregar hasta 4.
Host	IP	IPV6
a.zeit.world	96.45.80.1	2600:180a:1001::1
b.zeit.world	46.31.236.1	2600:180b:2001::1
c.zeit.world	43.247.170.1	2600:180c:3001::1
d.zeit.world	96.45.81.1	2600:180a:4001::1
e.zeit.world	46.31.237.1	2600:180b:5001::1
f.zeit.world	43.247.171.1	2600:180c:6001::1

Comprar dominio desde Zeit Domains:

Zeit te permite comprar dominios directamente desde su servicio.

$ now domain buy pagina.com

Asignar un dominio como alias:

También se puede asignar un dominio como el alias de un deploy.

$ now alias my-app-fdhdsd45.now.sh pagina.com

Otra forma de hacerlo es agregando el key alias en now.json.

{
  "alias": "pagina.com"
}

Nota: Para que el alias funcione, primero se debe de hacer configurado el hostname o haber comprado el dominio directamente desde now domains.

Componer Microservicios

La forma de gestionar una aplicación basada en microservicios es por medio de un archivo llamada rules.json.

{
  "rules": [
    {
      "pathname": "/graphql",
      "dest": "app.now.sh"
    },
    {
      "pathname": "/[ruta]",
      "dest": "app.now.sh"
    },
    {
      "dest": "app-principal.now.sh"
    }
  ]
}

Para establecer la configuración se ejecuta el comando:

now alias [aplicacion].now.sh -r rules.json Permite establecer las configuraciones de rules.json en un deploy de Now.sh.

Deploy desde Github

Se puede hacer deploy directamente a un repositorio de Github

now [usuario]/[repositorio]

Ejemplo de now.json

{
  "name": "nombre-de-la-aplicacion",
  "alias": "[alias-personalizado].now.sh",
  "env": {
    "NODE_ENV": "production",
    "PORT": "3000",
    "HOST": "0.0.0.0",
    "DB_USER": "@[db_user]",
    "DB_PASS": "@[db_pass]",
    "DB_HOST": "@[db_host]",
    "DB_NAME": "@[db_name]",
    "DB_PORT": "27017"
  },
  "type": "[npm]/[docker]/[static]"
}

Enlaces de Interés