#docker #container #personal-project #logs-streamer

bin+lib docker-container-log-streamer

A Rust library for streaming docker logs via websocket

1 unstable release

0.1.0 May 25, 2024

#67 in WebSocket

Download history 120/week @ 2024-05-20 14/week @ 2024-05-27 8/week @ 2024-06-03

142 downloads per month

Apache-2.0

36KB
335 lines

DOCKER LOGS STREAMER VIA WEBSOCKET

Stream docker logs using Websocket to your browser.

Build

cargo build --release

Deploy

Help Command:

cargo run -- --help

Usage: docker-container-log-streamer --stream-key <STREAM_KEY> --host <HOST> --port <PORT>

Options:
      --stream-key <STREAM_KEY>
          Stream Key used for Authentication

      --host <HOST>
          Host in IPV4 IP Address format

      --port <PORT>
          The port number to use

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Run using cargo

cargo run -- --stream-key mystreamkey --host 0.0.0.0 --port 3090

Run using the compiled binary file.

Build binary

cargo build --release

Execute binary

./target/release/docker-container-log-streamer --stream-key mystreamkey --host 0.0.0.0 --port 3090

Testing

You use the random-messages scripts to build the docker container and execute the docker-compose to simular the docker logs streamer.

  1. Build the random-messages container.
cd tests
docker build . -t random_messages:latest
  1. Execute docker-compose.
docker-compose -f docker-compose-random-messages.yml up

You can simulate the log streaming using the provided frontend app.

  1. Execute docker-compose for the frontend.
cd tests
docker-compose -f docker-compose-frontend.yaml up -d
  1. Look for the container of the frontend.
docker ps 

Example:
CONTAINER ID   IMAGE                    COMMAND                  CREATED       STATUS             PORTS                  NAMES
e6b8bedb2193   node                     "docker-entrypoint.s…"   3 hours ago   Up 3 hours         0.0.0.0:7050->80/tcp   tests-nginx-1
  1. Grab the container id
docker exec -it e6b8bedb2193 "bash"
  1. Run the development server.
cd app
yarn dev
  1. Open browser then go to
http://localhost:7090

Developer

JP Mateo (jpmateo022@gmail.com)

Dependencies

~17–30MB
~468K SLoC