Skip to content

Latest commit

 

History

History
executable file
·
228 lines (179 loc) · 9.06 KB

README.md

File metadata and controls

executable file
·
228 lines (179 loc) · 9.06 KB

Aplicación web y API sin servidor

IBM Cloud powered

Creará una aplicación web sin servidor alojando contenido de sitio web estático en GitHub Pages e implementando el programa de fondo de la aplicación mediante IBM Cloud™ Functions.

En lugar de suministrar una máquina virtual, un contenedor o un entorno de ejecución de Cloud Foundry para desplegar el programa de fondo, puede implementar la API de programa de fondo con una plataforma sin servidor. Esta puede ser una buena solución para evitar pagar por el tiempo de desocupación y dejar la plataforma se escale cuando sea necesario.

Functions de IBM Cloud

Plataforma de IBM cloud de programacion poliglota FaaS (Functions-as-a-Service) para desarrollo de codigo ligero que escala dependiendo de la demanda.

Para mayor informacion: Functions

Antes de empezar te recomendamos:

  • Realizar el PreWork.
  • Si eres estudiante o profesor y tienes correo institucional te recomendamos los Cupones.
  • Si tienes algun codigo promocional te decimos como Aplicarlos.

Repositorio para Fork y Clone:

IBM Developer Advocates Team

Módulo: Serverless Agenda

Crear y configurar Cloudant DB:

1.De nuestro catálogo en cloud.ibm.com buscamos Cloudant. 2.Seleccionamos Cloudant. 3.Lo nombramos guestbook-db, seleccionamos Legacy Credentials y IAM, posteriormente creamos una instancia del servicio. 4.Ya que el servicio este desplegado y listo para usar, en el tab de “Service Credentials” buscarmo si ya tenemos alguna creada, si no es asi, generamos una nueva credencial, que usaremos más adelante. 5.Volvemos a la tab de "Manage" y le damos click en “Launch dashboard”. 6.Nos vamos a la tab de lado izquierdo, damos click en "Create Database" y la nombramos "guestbook".

Configuración de Functions

En esta sección configuraremos nuestro servicio de Functions.

  1. Secuencia de acciones para escribir a la base de datos

    1. Vamos al catálogo y buscamos Cloud Functions.
    2. Una vez dentro seleccionamos "Actions".
    3. Damos click en "Create".
    4. Ponemos el nombre "prepare-entry-for-save" y seleccionamos "Node.js 12" como el Runtime, damos click en "Create".
    5. Cambiamos el código por el siguiente: 
      function main(params) {
 if (!params.nombre || !params.comentario) {
  return Promise.reject({ error: 'no nombre or comentario'});
  }
 return {
  doc: {
   createdAt: new Date(),
   nombre: params.nombre,
   correo: params.correo,
   comentario: params.comentario
  }
 };
}
    6. Lo salvamos.
    7. Para añadir nuestra acción a una secuencia primero nos vamos al tab “Enclosing Secuences” y damos click en “Add to Sequence”.
    8. Para el nombre de la secuencia ponemos "save-guestbook-entry-sequence" y posteriormente damos click en "Create and Add".
    9. Una vez que esta creada nuestra secuencia le damos click al nombre de la secuencia "save-guestbook-entry-sequence" y posteriormente damos click en "Add".
    10. Damos click en "Use Public" y seleccionamos "Cloudant".
    11. Seleccionamos la acción "create-document", damos click en "New Binding", ponemos de nombre de nuestro paquete "binding-for-guestbook" y en "Instance" seleccionamos "Input Your Own Credentials".
    12. Nos desplegara una lista. Para llenar estos datos copiamos las "credenciales" que tenemos en nuestro servicio de "Cloudant" y damos click en "Add", lo llenamos de la siguiente manera:
    • Username: Lo que viene en "username" sin comillas
    • Password: Lo que viene como "password" sin comillas
    • Host: Lo que viene en "host" sin comillas
    • Database: el nombre de la base de datos, en este caso es "guestbook"

    1. Para probar que esté funcionando, damos click en "save" y luego en "change input" e ingresamos nuestro siguiente JSON.
       {
   "nombre": "Isaac Carrada",
   "correo": "[email protected]",
   "comentario": "HOLA MUNDO"
   }

    1. Damos click en Apply y luego en Invoke:

    Una vez hecho esto y nos de una id de activacion correcta, podremos verlo escrito en nuestra base de datos de "Cloudant", en el "Dashboard", en la sección "Documents"

  2. Secuencia de acciones para obtener las entradas de la base de datos Esta secuencia la usaremos para tomar las entradas de cada usuario y sus respectivos comentarios, regresemos a "Functions/Actions".

    1. En nuestra tab de functions creamos una nueva acción Node.js y le ponemos el nombre "set-read-input", siguiendo el mismo proceso que en la acción anterior.
    2. Reemplazamos el código que viene, esta acción pasa los parámetros apropiados a nuestra siguiente acción: 
      function main(params) {
 return {
  params: {
   include_docs: true
   }
 };
}
    3. Damos click en "Save" y click en "Enclosing Sequences".
    4. Damos "Add to Sequence" y "Create New" con el nombre "read-guestbook-entries-sequence", y damos click en "Create and Add".
    5. Damos click en el nombre de la secuencia "read-guestbook-entries-sequence".
    6. Damos click en "Add" para crear una segunda acción en la secuencia.
    7. Seleccionamos "Public" y "Cloudant".
    8. Seleccionamos "list-documents" en actions y seleccionamos el binding "binding-for-guestbook" y posteriormente damos click en "Add".
    9. Damos click en "Save" y luego en "Add" para añadir una acción más a la secuencia, esta es la que va a dar el formato de los documentos cuando regresen de Cloudant.
    10. La nombraremos "format-entries" y posteriormente damos click en "Create and add"
    11. Damos click en "Save" y luego en nuestra accion "format-entries" y reemplazamos el código con: 
      const md5 = require('spark-md5');
	
function main(params) {
 return {
  entries: params.rows.map((row) => { return {
   nombre: row.doc.nombre,
   correo: row.doc.correo,
   comentario: row.doc.comentario,
   createdAt: row.doc.createdAt,
   icon: (row.doc.correo ? `https://secure.gravatar.com/avatar/${md5.hash(row.doc.correo.trim().toLowerCase())}?s=64` : null)
  }})
 };
}

    12. Salvamos y regresamos a nuestra secuencia para correrla con "invoke" (Esto lo podemos hacer dando click en acciones, y luego en nuestra secuencia, o en "Enclosing Sequence" y luego en nuestra secuencia)

Configurar el API

  1. Dentro de nuestras acciones seleccionamos ambas secuencias y en la tab de "Endpoints" damos click en "Enable Web Action" y damos click en "Save". Es importante que se haga para cada secuencia.

Y nos quede de la siguiente manera:

  1. Nos vamos a el tag "APIs" que esta de lado derecho.
  2. Damos click en "Create API"

  1. En el "API name *" ponemos "guestbook" y en el "Base path for API *" ponemos "/guestbook" y damos click en "create operation"

  1. Creamos un path que sea /entries ponemos el verbo a GET y seleccionamos la secuencia read-guestbook-entries-sequence y damos click en Create

  1. Realizamos la misma acción pero ahora con un POST y la secuencia save-guestbook-entries-sequence y damos click en Create

  1. Salvamos y exponemos la API

Despliegue

  1. Clonamos este repositorio en alguna carpeta de facil acceso
  2. Modificamos el docs/guestbook.js y reemplazamos el valor de apiUrl con la ruta dada por API Gateway, que obtenemos al dar click en APIs

  1. Hacemos push de esto a un nuevo repositorio.
  2. En el área de Settings>Github Pages, seleccionamos master branch /docs folder

  1. Podemos entrar a nuestra página en el link que aparece