{"id":23974629,"url":"https://github.com/hal/halos-proxy","last_synced_at":"2025-04-13T22:37:26.762Z","repository":{"id":69084849,"uuid":"262059551","full_name":"hal/halos-proxy","owner":"hal","description":"halOS Proxy","archived":false,"fork":false,"pushed_at":"2025-04-07T05:59:29.000Z","size":676,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T06:32:01.887Z","etag":null,"topics":["monitoring","openshift","wildfly"],"latest_commit_sha":null,"homepage":"","language":"Java","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/hal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-07T13:35:04.000Z","updated_at":"2025-04-07T05:59:27.000Z","dependencies_parsed_at":"2023-02-23T15:01:09.036Z","dependency_job_id":"616945ae-9ada-45c0-b024-6fa84cc1b266","html_url":"https://github.com/hal/halos-proxy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hal","download_url":"https://codeload.github.com/hal/halos-proxy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248793031,"owners_count":21162489,"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":["monitoring","openshift","wildfly"],"created_at":"2025-01-07T05:47:39.953Z","updated_at":"2025-04-13T22:37:26.682Z","avatar_url":"https://github.com/hal.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# halOS Proxy\n\nhalOS stands for **HAL** on **O**pen**S**hift. It is derived from [HAL](https://hal.github.io/)  and allows monitoring and inspection of WildFly and other services running on OpenShift. Although the focus is on WildFly, halOS supports monitoring arbitrary services. This is achieved through the concept of capabilities and extensions.\n\n## Architecture\n\n![halos](halos.svg)\n\nhalOS consists of two parts:\n\n1. Proxy (back-end, this repository)\n2. [Console](https://github.com/hal/halos-console) (front-end)\n\nThis repository contains the proxy. The proxy is a microservice running next to the managed services. It connects to the managed services and interacts with them. It exposes a REST API that is consumed by the [console](https://github.com/hal/halos-console).  \n\n## Technical Stack\n\n- [Quarkus](https://quarkus.io)\n- JAX-RS\n- Server Sent Events \n- fabric8 [OpenShift client](https://github.com/fabric8io/kubernetes-client)\n\n## Build\n\n```shell\n./mvnw install\n```\n\n## Run\n\nPlease refer to the halOS [distribution](https://github.com/hal/halos-distribution#readme) about how to set up all services on OpenShift, start halOS and access the console.\n\n## Development\n\nTo run the proxy, you need to have access to an OpenShift cluster. The easiest way to get started is to use the [OpenShift sandbox](https://developers.redhat.com/developer-sandbox). The sandbox provides you with a private OpenShift environment in a shared, multi-tenant OpenShift cluster that is pre-configured with a set of developer tools.\n\nOnce you have access to your OpenShift cluster, create a [`.env`](https://quarkus.io/guides/config-reference#env-file) file in the `proxy` folder and add the following settings:\n\n```shell\n_DEV_QUARKUS_KUBERNETES-CLIENT_MASTER-URL=\u003cOpenShift REST API\u003e\n_DEV_QUARKUS_KUBERNETES-CLIENT_TOKEN=\u003csecurity token\u003e\n_DEV_QUARKUS_KUBERNETES-CLIENT_NAMESPACE=\u003cyour namespace\u003e\n```\n\nThen start the proxy in dev mode, using\n\n```shell\ncd proxy\n./mvnw quarkus:dev\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhal%2Fhalos-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhal%2Fhalos-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhal%2Fhalos-proxy/lists"}