Deployments

• 1: Docker Compose
• 2: Kubernetes Daemonset
• 3: Systemd Bare-Metal

1 - Docker Compose

Image Download

Image repository: https://hub.docker.com/r/huatuo/huatuo-bamai/tags

Start a container with Docker

$ docker run --privileged --cgroupns=host --network=host -v /sys:/sys -v /proc:/proc -v /run:/run huatuo/huatuo-bamai:latest

⚠️ When this method is used, the container relies on the built-in default configuration file. That configuration does not connect to the kubelet or Elasticsearch.

Start containers with Docker Compose

Docker Compose allows you to quickly set up a complete local environment where you manage the collector, Elasticsearch, Prometheus, Grafana, and other components yourself.

$ docker compose --project-directory ./build/docker up

For Docker Compose installation instructions, see https://docs.docker.com/compose/install/linux/.

2 - Kubernetes Daemonset

This document describes how to deploy the Huatuo collector to a cloud-native cluster using a Kubernetes DaemonSet.

1. Download the configuration file

$ curl -L -o huatuo-bamai.conf https://github.com/ccfos/huatuo/raw/main/huatuo-bamai.conf

2. Modify the configuration file

Modify the configuration file according to your actual deployment environment. For example, adjust settings such as the storage backend and the method for obtaining Pod information. For details, see the Configuration Guide.

3. Create a ConfigMap

$ kubectl delete configmap huatuo-bamai-config
$ kubectl create configmap huatuo-bamai-config --from-file=./huatuo-bamai.conf

3. Deploy the Collector

$ kubectl apply -f https://github.com/ccfos/huatuo/blob/main/build/huatuo-daemonset.minimal.yaml

Notes:

• In huatuo-daemonset.minimal.yaml, the container image uses the huatuo-bamai:latest tag by default. For production deployments, replace it with a specific release version image.
• When using huatuo-bamai:latest for testing, verify that the tag points to the latest image. You can remove the old image and pull it again by running docker image rm huatuo/huatuo-bamai:latest.

3 - Systemd Bare-Metal

The RPM release of HUATUO is available from the OpenCloudOS repository. Only version 2.1.0 is currently supported.

1. Download the RPM package

The OpenCloudOS mirror provides the HUATUO RPM package. Download the appropriate package for your architecture:

wget https://mirrors.opencloudos.tech/epol/9/Everything/x86_64/os/Packages/huatuo-bamai-2.1.0-2.oc9.x86_64.rpm  
wget https://mirrors.opencloudos.tech/epol/9/Everything/aarch64/os/Packages/huatuo-bamai-2.1.0-2.oc9.aarch64.rpm

2. Install the RPM package

sudo rpm -ivh huatuo-bamai*.rpm

3. Modify the configuration

Edit the configuration file /etc/huatuo-bamai/huatuo-bamai.conf to match your deployment environment. For detailed configuration options, refer to the Configuration Guide.

4. Start the HUATUO service

sudo systemctl start huatuo-bamai
sudo systemctl enable huatuo-bamai

For complete installation instructions, see https://mp.weixin.qq.com/s/Gmst4_FsbXUIhuJw1BXNnQ