RanchiMall/blockbook-docker
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Step guide for dockerising blockbook

Browse Source
This commit is contained in:
Kumar Sahaj 2023-09-20 13:57:14 +00:00
parent f1fcec6a28
commit 8bda098621
1 changed files with 76 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
README.md
View File

@ -8,6 +8,82 @@ Should have [sysbox installed on your machine](https://github.com/nestybox/sysbo
sudo docker run -d --runtime=sysbox-runc -P -p <hostport>:9166 --name blockbook ranchimallfze/blockbook:1.0.0
```
## Requirements
Installation of Sysbox:
1. $ git clone --recursive https://github.com/nestybox/sysbox.git
2. $ make (For this step go to the sysbox directory)
3. $ make sysbox-static
4. $ sudo make install
5. $ make sysbox TARGET_ARCH=arm64
6. $ sudo ./docker-cfg --sysbox-runtime=enable (For this step go to the scr directory)
If in step 6 command not found error comes then first install jq and then again run this command.
For Uninstalling:
1. $ sudo make uninstall
2. $ make clean
Installation of Docker:
1. $ sudo apt update
2. $ sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
3. $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
4. $ echo "deb [signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu
focal stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
(Replace focal with your Ubuntu version (e.g., bionic, xenial, or hirsute) if you are using a different version)
5. $ sudo apt update
6. $ sudo apt install -y docker-ce docker-ce-cli containerd.io
7. $ sudo systemctl start docker
$ sudo systemctl enable docker
8. $ sudo docker --version (If installed correctly the version will be displayed)
## Running Manually
1. After the installation of docker and sysbox run the dockerfile.
For running first we build its docker-image by the following command:
```
docker build -t <IMG_NAME> . <!--If the directory of the dockerfile and the present directory is same-->
docker build -f <PATH_TO_DOCKERFILE> -t <IMG_NAME> <DOCKERFILE DIRECTORY>
<!--If the directory of the dockerfile and the present directory is not same-->
```
2. After building the docker-image use the following command to run it.
```
docker run -d --privileged -p <CONTAINER_PORT>:<HOST_PORT> --name <CONTAINER_NAME> <IMG_NAME>
<!--The container port for our docker file is 9166.-->
docker run -d --privileged -p 9166:<HOST_PORT> --name <CONTAINER_NAME> <IMG_NAME>
```
3. Now access the blockbook by opening the following LINK: https://localhost:<HOST_PORT>/
Use xdg-open https://localhost:<HOST_PORT>/ to open the link through the terminal and can view the interface of Blockbook.
## Code Explanation
. We use the base image "nestybox/ubuntu-focal-systemd-docker," which is an Ubuntu-based image with systemd for managing system
services.
. We update the package list and installs necessary packages like wget, gnupg2, software-properties-common, and unzip.
. The Dockerfile downloads a ZIP archive containing Debian (.deb) files from a GitHub repository and extracts them.
. Within the extracted directory, it installs two Debian packages ("dind_backend-flo_0.15.1.1-satoshilabs-1_amd64.deb" and
"dind_blockbook-flo_0.4.0_amd64.deb") using apt.
. It exposes three ports (22, 80, and 9166) for potential network access.
. The CMD instruction specifies the default command to run when a container is started based on this image. In this case, it starts the
systemd initialization process.
### Why Sysbox Is Used ?
. When you run Docker containers inside a Docker container (DinD), the inner containers typically share the same Docker daemon as the
host and other containers. This can lead to security and isolation concerns. Sysbox allows you to run containers within an isolated environment, providing stronger separation between inner containers, the host, and other outer containers. This is achieved by creating separate container runtimes for each inner container using runc (the OCI runtime).
. In our dockerfile we are able to execute systemctl command by using sysbox.
## Testing
The code and steps required to run Docker version of Blockbook block explorer