{"id":20475233,"url":"https://github.com/hawkular/hawkinit","last_synced_at":"2025-04-13T12:30:29.244Z","repository":{"id":57115360,"uuid":"74773540","full_name":"hawkular/hawkinit","owner":"hawkular","description":"Simple CLI tool that spawns linked docker containers with Hawkular and some monitored stuff.","archived":false,"fork":false,"pushed_at":"2017-09-22T22:24:47.000Z","size":9292,"stargazers_count":5,"open_issues_count":12,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-03T06:36:57.522Z","etag":null,"topics":["docker","docker-compose","hawkular","npm-package"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hawkular.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-25T16:30:20.000Z","updated_at":"2017-03-20T14:39:22.000Z","dependencies_parsed_at":"2022-08-22T10:40:43.978Z","dependency_job_id":null,"html_url":"https://github.com/hawkular/hawkinit","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hawkular%2Fhawkinit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hawkular%2Fhawkinit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hawkular%2Fhawkinit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hawkular%2Fhawkinit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hawkular","download_url":"https://codeload.github.com/hawkular/hawkinit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248714204,"owners_count":21149847,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","hawkular","npm-package"],"created_at":"2024-11-15T15:15:07.013Z","updated_at":"2025-04-13T12:30:29.210Z","avatar_url":"https://github.com/hawkular.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hawkinit\n\nSimple CLI tool that spawns linked docker containers with [Hawkular](http://hawkular.org) and some monitored stuff.\n\n[![Build Status](https://travis-ci.org/hawkular/hawkinit.svg?branch=master)](https://travis-ci.org/hawkular/hawkinit)\n[![npm version](https://badge.fury.io/js/%40hawkular%2Fhawkinit.svg)](https://badge.fury.io/js/%40hawkular%2Fhawkinit)\n\n## About\n\nThis simple CLI tool helps you with starting the hawkular-services together with some monitored WildFly servers. Internally, it uses the docker-compose tool and exposes the service on `localhost:8080`.\n\n## How to install\n\n```bash\n$ sudo npm install @hawkular/hawkinit -g\n```\n\n## How to update\n\n```bash\n$ sudo npm update @hawkular/hawkinit -g\n```\n\n## Usage\n\n```bash\n$ hawkinit\n```\nChoose the versions of `hawkular-services`, Cassandra and instrumented WildFly server you want to start, number of containers or if you want to run WF in standalone mode or in a managed domain. For the domain mode couple of [scenarios](https://github.com/Jiri-Kremser/hawkfly-domain-dockerfiles#scenarios) are prepared. Once every question is answered, you should start seeing the logs from particular containers. Congrats, your hawkular-service is up and running on `http://localhost:8080`.\n\nFor more help:\n\n```bash\n$ hawkinit -h\n```\n\n![cli demo](https://github.com/hawkular/hawkinit/raw/gif/demo.gif)\n\n\n## Advanced Mode\nBy default hawkinit asks only limited amount of questions and assumes some default values for some advanced settings.\nTo activate the advanced mode, simply run the hawkinit with `-f` or `--full` flag.\nThese are the features that are available in the advanced mode:\n* custom version of the cassandra container\n* multiple cassandra nodes\n* multiple host controllers\n* various scenarios for domain mode\n* SSL support\n* creating custom user in the hawkular-services container\n* overriding the immutable flag\n* and more will come\n\n\n## Requirements\nThe `hawkinit` assumes the `docker` and `docker-compose` to be installed, Docker version should be higher than `1.12.0` and also the user that runs the command should be in the `docker` group.\n\n```bash\nsudo usermod -a -G docker `whoami`\n```\n\nAdd yourself to that group for current session (or logout and log in).\n```bash\nnewgrp docker\n```\n\nMake sure the docker deamon is up and running.\n\n```bash\nsudo systemctl enable docker --now\n```\n\nMake sure the `/tmp/opt/data` is created and owned by user with `UID = 1000`.\nRunning following command as non-root (as user with `UID=1000`) should work.\n\n```bash\nmkdir -p /tmp/opt/data/ \u0026\u0026 sudo chown -R $UID:$UID /tmp/opt/data/\n```\n\n### Fedora\nOn Fedora 24 the Docker that is in the default yum repo is obsolete, so remove it and install the docker-engine package from the yum.dockerproject.org repo.\n\n`sudo dnf remove docker` and follow these instructions https://docs.docker.com/engine/installation/linux/fedora/\n\n### Debian\n`sudo apt-get install docker.io docker-compose`\n\n## Troubleshooting\nMake sure you've installed the hawkinit as `@hawkular/hawkinit` because historically, there was also `hawkinit` npm package.\n\nIf you run the hawkinit, it says something like:\n\n```bash\nLater, you can find your hawkular-services listening on http://localhost:8080\nRunning 'docker-compose up --force-recreate' in directory: /tmp/tmp-11573k3ujXFLACh9z\n```\n\nIf you navigate to `/tmp/tmp-11573k3ujXFLACh9z`, you can run `docker-dompose up` to start it again. This is not a standard use-case, though. Any other `docker-compose` command works just fine. So for instance you may want to see only the Cassandra logs by `docker-compose logs -f myCassandra` or inspecting the Hawkular Services container by `docker-compose exec hawkular /bin/bash`, etc. Also, nothing protects you from editing the `docker-compose.yml` file that was created in that tmp directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhawkular%2Fhawkinit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhawkular%2Fhawkinit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhawkular%2Fhawkinit/lists"}