introspector

Contents

This projects generates couple of products. Each one packed in a docker image:

• agent - Agent to bm-inventory
• inventory - A container image that provides inventory information
• connectivity_check - A container image for running connectivity_check
• free_addresses - A container image for running nmap to detect free addresses

agent

The agent communicates with bm-inventory. It uses the ghw library to generate unique uuid identifying the host that the agent is running on. Currently, the functionality of connectivity_check is also bundled in the agent itself, besides its dedicated container images.

Flags

• --host: Deprecated, use --url instead. The inventory host as dns name or ip address. Default is "api.openshift.com".
• --port: Deprecated, use --url instead. The inventory port number. Default is 80.
• --url: The inventory URL, including a schema and optionally a port. Overrides the host and port arguments. If not provided, "http://<host>:<port>" will be used.
• --cluster-id: The cluster id. Default is "default-cluster".
• --interval: Interval in seconds between consecutive times that the agent accesses the inventory. Default is 60.
• --inventory-image: The name of the inventory image. Default is "quay.io/ocpmetal/inventory:latest"
• --text: Dump the inventory as json to the standard output and exit.
• --connectivity: Perform connectivity check and dump the results as json to the standard output. The details of the nodes to check the connectivity with are provided as a parameter having json format.
• --with-text-logging: Enable writing the agent logs to /var/log/agent.log. Default is true.
• --with-journal-logging: Enable writing logs to systemd journal. Default is true.
• --help: Provide help message.

Packaging

The agent's executable is packaged in a container quay.io/ocpmetal/agent:latest. The excutable in the container is /usr/bin/agent.

Running

Since the agent is a statically linked go executable it can be copied and ran outside a container.If running outside a container, the agent shoud run as root. If running in a container, the docker or podman should be invoked with --net=host and --privileged flags.

Dependecies

• docker

Building

introspector uses skipper for building and testing.

To build executables run: skipper make

To build container images run: skipper make build-image

Testing

Unitests: Run skipper make unittest

The subsystem tests uses docker-compose to run the agent and wiremock simulating the inventory.

To perform the subsystem test run: skipper make subsystem

Deployment

To deploy all container images in the project run skipper make push