From 62cdc99dd4f4909a5794a35c28b91282dae14f2b Mon Sep 17 00:00:00 2001 From: Robert Martin-Legene <robert@nic.ar> Date: Fri, 27 Sep 2019 16:18:22 -0300 Subject: [PATCH] Update README.md --- README.md | 49 ++++++++++++++++++++++++++----------------------- 1 file changed, 26 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 5200526..672533d 100644 --- a/README.md +++ b/README.md @@ -4,10 +4,10 @@ ### Caracteristicas -El `bfanodo` es un docker que podes bajar y correr en tu propia -maquina o datacenter. Se va a levantar como un nodo transaccional, -**sin cuentas**, abierto a todo el mundo. -Si no queres brindar este servicio a la red, podes usar ipfilter o +El **bfanodo** es un container/docker que podes bajar y correr en tu +propia maquina, maquina virtual o datacenter. Se levanta como un nodo +transaccional, **sin cuentas**, abierto a todo el mundo. +Si no queres brindar este servicio a la red, podes usar *ipfilter* o (mas facil) no publicar el puerto 8545 (atalo (bind) a 127.0.0.1 solamente, igual que puerto 8546). Para hacer eso, tenes que cambiar los parametros `-p` en `start.sh`. @@ -26,7 +26,7 @@ Es importante entender que "tu maquina" incluye otros dockers en la misma maquina, si las has conectado con el parametro `--link`, como se puede ver aqui: ``` -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_PORT=30303 BFANODO_PORT_30303_TCP_PROTO=tcp @@ -48,7 +48,7 @@ BFANODO_PORT=tcp://172.17.0.2:8545 Los puertos estan disponibles de los otros dockers tambien sin usar `--link` pero no van a estar publicados en 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 Content-Type: text/plain; charset=utf-8 Connection: close @@ -67,37 +67,40 @@ Las cuentas deben estar asociados a los applicaciones que se conecta al nodo. Ese hace es sistema mas seguro, y **cada applicacion necesita su propia cuenta**. -### Para usar - -``` -wget https://gitlab.bfa.ar/docker/bfanodo/raw/master/start.sh -./start.sh -``` - Si no sos miembro del grupo `docker` (en `/etc/group` ) tenes que 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. -### Avisos del sistema +### Instalando Docker + +En [https://docs.docker.com/install/] hay instrucciones para instalar Docker para varios +sistemas (CentOS, Debian, Fedora, Ubuntu). -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, 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 Normalmente es suficiente con: ``` -echo 'GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"' >> /etc/default/grub -update-grub -reboot +$ echo 'GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"' >> /etc/default/grub +$ update-grub +$ reboot +``` + +### Instalando bfanodo + +``` +$ wget https://gitlab.bfa.ar/docker/bfanodo/raw/master/start.sh +$ ./start.sh ``` ### Registros / logs Para ver como esta tu bfanodo, estos comandos pueden brindar mas informacion (y hasta darte un shell): ``` -docker stats bfanodo -docker logs bfanodo -docker exec bfanodo bfalog.sh -docker exec bfanodo localstate.pl -docker exec -it bfanodo bash +$ docker stats bfanodo +$ docker logs bfanodo +$ docker exec bfanodo bfalog.sh +$ docker exec bfanodo localstate.pl +$ docker exec -it bfanodo bash ``` ### Crear -- GitLab