Skip to content
Snippets Groups Projects
Commit d62ce4e5 authored by Daniel Franca's avatar Daniel Franca
Browse files

Update README.md

parent 4d382dc6
No related branches found
No related tags found
1 merge request!1Update README.md
This commit is part of merge request !1. Comments created here will be created in the context of that merge request.
...@@ -4,15 +4,16 @@ ...@@ -4,15 +4,16 @@
### Caracteristicas ### Caracteristicas
El **bfanodo** es un container/docker que podes bajar y correr en tu El **bfanodo** es un container/Docker se puede descargar y correr en tu
propia maquina, maquina virtual o datacenter. Se levanta como un nodo propia maquina, maquina virtual o datacenter.
transaccional, **sin cuentas**, abierto a todo el mundo.
Si no queres brindar este servicio a la red, podes usar *ipfilter* o Se levanta como un nodo transaccional, **sin cuentas**, abierto a todo el mundo.
(mas facil) no publicar el puerto 8545 (atalo (bind) a 127.0.0.1 Si no deseas brindar este servicio a la red, se puede usar *ipfilter* o,
solamente, igual que puerto 8546). Para hacer eso, tenes que cambiar directamente no publicar el puerto 8545 (anclado únicamente a 127.0.0.1,
los parametros `-p` en `start.sh`. igual que puerto 8546). Para hacer eso, hay que cambiar los parametros
`-p` en `start.sh`.
Como ves en el ejemplo abajo, puerto 30303/tcp y 8545/tcp estan abiertos al
Como se puede apreciar en el ejemplo aquí abajo, los puertos 30303/tcp y 8545/tcp estan abiertos al
mundo (0.0.0.0 = INADDR_ANY) y 8546/tcp esta abierto solamente para mundo (0.0.0.0 = INADDR_ANY) y 8546/tcp esta abierto solamente para
conecciones de tu maquina. conecciones de tu maquina.
``` ```
...@@ -24,7 +25,7 @@ $ docker container port bfanodo ...@@ -24,7 +25,7 @@ $ docker container port bfanodo
Es importante entender que "tu maquina" incluye otros dockers en Es importante entender que "tu maquina" incluye otros dockers en
la misma maquina, si las has conectado con el parametro `--link`, la misma maquina, si las has conectado con el parametro `--link`,
como se puede ver aqui: como se puede ver aqui: (NOTA DE FRANCA: ESTO NO LO ENTIENDO)
``` ```
$ docker run --rm -it --link bfanodo alpine env | grep BFANODO_PORT | sort $ docker run --rm -it --link bfanodo alpine env | grep BFANODO_PORT | sort
BFANODO_PORT_30303_TCP_ADDR=172.17.0.2 BFANODO_PORT_30303_TCP_ADDR=172.17.0.2
...@@ -45,8 +46,8 @@ BFANODO_PORT_8546_TCP_PROTO=tcp ...@@ -45,8 +46,8 @@ BFANODO_PORT_8546_TCP_PROTO=tcp
BFANODO_PORT_8546_TCP=tcp://172.17.0.2:8546 BFANODO_PORT_8546_TCP=tcp://172.17.0.2:8546
BFANODO_PORT=tcp://172.17.0.2:8545 BFANODO_PORT=tcp://172.17.0.2:8545
``` ```
Los puertos estan disponibles de los otros dockers tambien sin usar Los puertos de los otros dockers están disponibles, sin usar
`--link` pero no van a estar publicados en variables del entorno. `--link` . Pero no van a estar publicados en las variables del entorno.
``` ```
$ docker run --rm alpine sh -c "date | nc 172.17.0.2 8545" ; echo $ docker run --rm alpine sh -c "date | nc 172.17.0.2 8545" ; echo
HTTP/1.1 400 Bad Request HTTP/1.1 400 Bad Request
...@@ -59,24 +60,24 @@ Connection: close ...@@ -59,24 +60,24 @@ Connection: close
### Cuentas ### Cuentas
Una leccion aprendido durante el primer año de BFA es, que el `geth` Una leccion aprendida durante el primer año de BFA es que el `geth`
normalmente no necesita una cuenta asociado (eso obviamente es distinto si normalmente no necesita una cuenta asociada (esto obviamente es distinto si
lo usas como nodo sellador). se utiliza como nodo sellador).
Las cuentas deben estar asociados a los applicaciones que se conecta al Las cuentas deben estar asociadas a las applicaciones que se conectan al
nodo. Ese hace es sistema mas seguro, y **cada applicacion necesita su nodo. Esto hace que el sistema sea más seguro, y que **cada applicacion necesite su
propia cuenta**. propia cuenta**.
Si no sos miembro del grupo `docker` (en `/etc/group` ) tenes que hacer todo como `root` Si no sos miembro del grupo `docker` (en `/etc/group` ) deberás hacer todo como `root`
Te va a crear un directorio en `~/dockers/volumes/bfanodo,home,bfa,bfa,network,node,geth` . Si tenes cuentas/llaves van ahi. Toda la blockchain tambien se ve ahi, para que no hay que bajar toda la blockchain de vuelta al actualizar el nodo. Así, se creará un directorio en `~/dockers/volumes/bfanodo,home,bfa,bfa,network,node,geth` . Si tenés cuentas/llaves van allí. Toda la blockchain tambien se puede ver en ese mismo lugar, para que no hay que bajar toda la blockchain de vuelta al actualizar el nodo. (NOTA DE FRANCA: NO ENTIENDO ESTA ULTIMA PARTE)
### Instalando Docker ### Instalando Docker
En [https://docs.docker.com/install/] hay instrucciones para instalar Docker para varios En [https://docs.docker.com/install/] hay instrucciones para instalar Docker para varios
sistemas (CentOS, Debian, Fedora, Ubuntu). sistemas (CentOS, Debian, Fedora, Ubuntu).
Una vez instalado, podes correr varios dockers a la vez. Si ves el aviso `WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.` la solucion posible esta en https://docs.docker.com/install/linux/linux-postinstall/#your-kernel-does-not-support-cgroup-swap-limit-capabilities Una vez instalado, podés correr varios dockers a la vez. Si ves el aviso `WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.` la solucion posible está en https://docs.docker.com/install/linux/linux-postinstall/#your-kernel-does-not-support-cgroup-swap-limit-capabilities
Normalmente es suficiente (en Debian) con: Normalmente es suficiente (en Debian) con:
``` ```
...@@ -94,7 +95,7 @@ $ ./start.sh ...@@ -94,7 +95,7 @@ $ ./start.sh
### Registros / logs ### Registros / logs
Para ver como esta tu bfanodo, estos comandos pueden brindar mas informacion (y hasta darte un shell): Estos comandos pueden brindar mas informacion sobre tu bfanodo (y hasta darte un shell):
``` ```
$ docker stats bfanodo $ docker stats bfanodo
$ docker logs bfanodo $ docker logs bfanodo
...@@ -105,4 +106,4 @@ $ docker exec -it bfanodo bash ...@@ -105,4 +106,4 @@ $ docker exec -it bfanodo bash
### Crear ### Crear
Para crear el docker uso el script `build.sh`. No lo uses si no sabes como funciona todo. Para crear el docker se utilizó el script `build.sh`. Por favor, no lo uses si no sabés como funciona todo.
\ No newline at end of file \ No newline at end of file
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment