generated from Arquisoft/dede_0
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
8 changed files
with
117 additions
and
346 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,51 +1,52 @@ | ||
# dede_0 | ||
# asw2122_0 | ||
|
||
[![Actions Status](https://github.com/arquisoft/dede_0/workflows/CI%20for%20ASW2122/badge.svg)](https://github.com/arquisoft/dede_0/actions) | ||
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Arquisoft_dede_0&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Arquisoft_dede_0) | ||
[![codecov](https://codecov.io/gh/arquisoft/dede_0/branch/master/graph/badge.svg?token=VN4XG9NTRO)](https://codecov.io/gh/pglez82/asw2122_0) | ||
[![Actions Status](https://github.com/pglez82/asw2122_0/workflows/CI%20for%20ASW2122/badge.svg)](https://github.com/pglez82/asw2122_0/actions) | ||
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=pglez82_asw2122_0&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=pglez82_asw2122_0) | ||
[![codecov](https://codecov.io/gh/pglez82/asw2122_0/branch/master/graph/badge.svg?token=VN4XG9NTRO)](https://codecov.io/gh/pglez82/asw2122_0) | ||
|
||
<p float="left"> | ||
<img src="https://blog.wildix.com/wp-content/uploads/2020/06/react-logo.jpg" height="100"> | ||
<img src="https://miro.medium.com/max/1200/0*RbmfNyhuBb8G3LWh.png" height="100"> | ||
<img src="https://miro.medium.com/max/365/1*Jr3NFSKTfQWRUyjblBSKeg.png" height="100"> | ||
</p> | ||
|
||
Este proyecto es un ejemplo basico de un sitio web utilizando **React** con **Typescript** y un endpoint usando **NodeJS** con **express** | ||
|
||
This project is a basic example of website using **React** with **Typescript** and an endpoint using **NodeJS** with **express**. | ||
## Guia de inicio rápido | ||
|
||
## Quick start guide | ||
<mark>In case you already have node.js and npm, make sure you update them before attempting to build the images</mark> | ||
<mark>Si tienes instalados node.js y npm, asegurate de actualizarlos antes de intentar construir las imagenes</mark> | ||
|
||
Si quieres ejecutar el proyecto necesitarás [git](https://git-scm.com/downloads), [Node.js and npm](https://www.npmjs.com/get-npm) y [Docker](https://docs.docker.com/get-docker/). Asegurate de tenerlos instalados en tu equipo. Descarga el proyecto con `git clone https://github.com/pglez82/asw2122_0`. La manera más rápìda de ejecutar todo es con Docker. | ||
|
||
If you want to execute the project you will need [git](https://git-scm.com/downloads), [Node.js and npm](https://www.npmjs.com/get-npm) and [Docker](https://docs.docker.com/get-docker/). Make sure the three of them are installed in your system. Download the project with `git clone https://github.com/arquisoft/dede_0`. The fastest way to launch everything is with docker: | ||
```bash | ||
docker-compose up --build | ||
``` | ||
This will create two docker images as they don't exist in your system (the webapp and the restapi) and launch a mongo container database. It will also launch Prometheus and Grafana containers to monitor the webservice. You should be able to access everything from here: | ||
Este comando creará dos imagenes de docker si no existen en tu equipo (la webapp y la restapi) y lanzará un contenedor de mongoDB. Además lanzará contenedores de Prometheus y Grafana para monitorizar el servicio web. Deberias ser capaz de acceder a todo desde aqui: | ||
|
||
- [Webapp - http://localhost:3000](http://localhost:3000) | ||
- [RestApi example call - http://localhost:5000/api/users/list](http://localhost:5000/api/users/list) | ||
- [RestApi raw metrics - http://localhost:5000/metrics](http://localhost:5000/metrics) | ||
- [Prometheus server - http://localhost:9090](http://localhost:9090) | ||
- [Grafana server http://localhost:9091](http://localhost:9091) | ||
- [Ejemplo llamada a RestApi - http://localhost:5000/api/users/list](http://localhost:5000/api/users/list) | ||
- [Metricas RestApi - http://localhost:5000/metrics](http://localhost:5000/metrics) | ||
- [Servidor Prometheus - http://localhost:9090](http://localhost:9090) | ||
- [Servidor Grafana http://localhost:9091](http://localhost:9091) | ||
|
||
If you want to run it without docker. Compile and run the restapi: | ||
Si quieres ejecutar el proyecto sin Docker primero complila y ejecuta la restapi: | ||
|
||
```shell | ||
cd restapi | ||
npm install | ||
npm start | ||
``` | ||
|
||
Now the webapp: | ||
|
||
a continuación la webapp: | ||
```shell | ||
cd webapp | ||
npm install | ||
npm start | ||
``` | ||
|
||
You should be able to access the application in [http://localhost:3000](http://localhost:3000). | ||
Deberias ser capaz de acceder a la aplicación en [http://localhost:3000](http://localhost:3000). | ||
|
||
## More information | ||
You can get more information about the respository in the other README files: | ||
- Documentation: https://github.com/arquisoft/dede_0/tree/master/docs | ||
- Webapp: https://github.com/arquisoft/dede_0/tree/master/webapp | ||
- Restapi: https://github.com/arquisoft/dede_0/tree/master/restapi | ||
## Mas información | ||
Encontrarás más información sobre el repositorio en los otros archivos README: | ||
- Documentación: https://github.com/pglez82/asw2122_0/tree/master/docs | ||
- Webapp: https://github.com/pglez82/asw2122_0/tree/master/webapp | ||
- Restapi: https://github.com/pglez82/asw2122_0/tree/master/restapi |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,35 +1,37 @@ | ||
## The documentation | ||
In this project the documentation is compiled locally and deployed to GitHub pages. | ||
The deployment url is: [https://pglez82.github.io/asw2122_0/](https://pglez82.github.io/asw2122_0/). | ||
## Documentación | ||
La documentación de este proyecto se compila localmente y se despliega en GitHub pages. | ||
la url en la que se despliega es: [https://arquisoft.github.io/dede_0/](https://arquisoft.github.io/dede_0/). | ||
|
||
### Documentation build | ||
For the documentation we are going to use [AsciiDoc](https://asciidoc.org/) and [PlantUML](https://plantuml.com) and follows the [Arc42](https://github.com/arc42/arc42-template) template. If you want to be able to generate the doc locally you need to install Ruby, Java and some dependencies to translate the asciidoc code into html. If you are in Linux you can install Ruby and Java simply by executing: | ||
### Build Documentación | ||
For the documentation we are going to use [AsciiDoc](https://asciidoc.org/) and [PlantUML](https://plantuml.com) and follows the [Arc42](https://github.com/arc42/arc42-template) template. If you want to be able to generate the doc locally you need to install Ruby and some dependencies to translate the asciidoc code into html: | ||
|
||
Para la documentación vamos a utilizar [AsciiDoc](https://asciidoc.org/) y [PlantUML](https://plantuml.com). Seguiremos la plantilla [Arc42](https://github.com/arc42/arc42-template). Si quieres general la documentación en tu ordenador, necesitas instalar Ruby, Java y algunas dependencias para traducir el asciidoc en código html. Si estás en una máquina Linux puedes instalar Java y Ruby simplemente ejecutando: | ||
|
||
```shell | ||
apt-get install ruby openjdk-8-jre | ||
``` | ||
|
||
On Windows you can use [these instructions](https://www.ruby-lang.org/en/documentation/installation). Probably you will have Java already installed in your system, if not, you can download it [here](https://www.oracle.com/es/java/technologies/javase/javase8-archive-downloads.html) | ||
En Windows puedes seguir [estas instrucciones](https://www.ruby-lang.org/en/documentation/installation) para instalar Ruby. Probablemente tengas un JRE de Java instalado, sino puedes descargarlo [aquí](https://www.oracle.com/es/java/technologies/javase/javase8-archive-downloads.html): | ||
|
||
Once Ruby is working you can install some gems with `asciidoctor` and `asciidoctor-diagram`. | ||
Una vez que Ruby está instalado y funcionando podemos instalar `asciidoctor` y `asciidoctor-diagram`. | ||
|
||
```shell | ||
gem install asciidoctor asciidoctor-diagram | ||
``` | ||
|
||
Now it is turn to install some dependencies in the `package.json` file inside the `docs` directory: | ||
Ahora solo nos queda instalar las dependencias del `package.json` dentro del directorio `docs`: | ||
|
||
```shell | ||
cd docs | ||
npm install | ||
``` | ||
After installing these tools we can generate the documentation. | ||
Después de instalar todas estas herramientas ya deberíamos de ser capaces de generar la documentación: | ||
```shell | ||
npm run build | ||
``` | ||
The documentation will be generated under the `docs/build` directory. | ||
La documentación se generará en el directorio `docs/build`. | ||
|
||
### Documentation deployment | ||
If we want to deploy it to GitHub pages, so it is accesible via [https://pglez82.github.io/asw2122_0/](https://pglez82.github.io/asw2122_0/) we need to execute `npm run deploy`. | ||
### Despliegue Documentación | ||
Si queremos desplegar la documentación en GitHub pages, estará accesible en [https://arquisoft.github.io/dede_0/](https://arquisoft.github.io/dede_0/) necesitamos ejecutar `npm run deploy`. | ||
|
||
If you check the `package.json` in this directory you can see how deploying is as easy as executing `gh-pages -d build`, which can be directly executed using `npm run deploy` in the docs directory. The `gh-pages` package is in charge of pushing the documentation generated directory (basically some htmls) to a special github branch called gh-pages. Everything pushed to this branch is accessible in the repository page. Note that we only want to push there the documentation. Also is important that the documentation build is not pushed to the other branches of the project. | ||
Si revisas el `package.json` de este directorio veras como desplegar es tan facil como ejecutar `gh-pages -d build`, que puede hacerse ejecutando directamente `npm run deploy` en el directorio de la doumentación. el paquete `gh-pages` se encarga de subir la documentación generada (basicamente archivo html) a una rama especial de github llamda gh-pages. Todo lo que se suba a esa rama es acesible en la página del repositorio. Ten en cuenta que solo queremos subir ahí la documentación. También es importante que el build de la documentación no se suba a otras ramas del proyecto. |
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.