{"id":13487616,"url":"https://github.com/apache/dubbo-admin","last_synced_at":"2025-05-14T05:10:37.301Z","repository":{"id":37743057,"uuid":"117054584","full_name":"apache/dubbo-admin","owner":"apache","description":"The ops and reference implementation for Apache Dubbo","archived":false,"fork":false,"pushed_at":"2025-05-07T01:40:19.000Z","size":14309,"stargazers_count":4015,"open_issues_count":253,"forks_count":2164,"subscribers_count":227,"default_branch":"develop","last_synced_at":"2025-05-10T17:16:25.280Z","etag":null,"topics":["dubbo"],"latest_commit_sha":null,"homepage":"https://dubbo.apache.org","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/apache.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-11T05:30:17.000Z","updated_at":"2025-05-09T10:01:43.000Z","dependencies_parsed_at":"2024-01-16T09:01:28.606Z","dependency_job_id":"5668b1de-19fd-42d4-ac5a-b684af7daf97","html_url":"https://github.com/apache/dubbo-admin","commit_stats":{"total_commits":635,"total_committers":84,"mean_commits":7.559523809523809,"dds":0.552755905511811,"last_synced_commit":"7bca862a7d13d7f20ce415b15bfa71d4ead88d16"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fdubbo-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fdubbo-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fdubbo-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fdubbo-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/dubbo-admin/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253857184,"owners_count":21974694,"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":["dubbo"],"created_at":"2024-07-31T18:01:01.256Z","updated_at":"2025-05-14T05:10:37.268Z","avatar_url":"https://github.com/apache.png","language":"Java","readme":"# Dubbo Admin\n\n[![Build](https://github.com/apache/dubbo-admin/actions/workflows/ci.yml/badge.svg)](https://github.com/apache/dubbo-admin/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/apache/dubbo-admin/branch/develop/graph/badge.svg)](https://codecov.io/gh/apache/dubbo-admin/branches/develop)\n![license](https://img.shields.io/github/license/apache/dubbo-admin.svg)\n[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/apache/dubbo-admin.svg)](http://isitmaintained.com/project/apache/dubbo-admin \"Average time to resolve an issue\")\n[![Percentage of issues still open](http://isitmaintained.com/badge/open/apache/dubbo-admin.svg)](http://isitmaintained.com/project/apache/dubbo-admin \"Percentage of issues still open\")\n\nDubbo Admin is the console designed for better visualization of Dubbo services, it provides support for Dubbo3 and is compatible with 2.7.x, 2.6.x and 2.5.x.\n\n![index](https://raw.githubusercontent.com/apache/dubbo-admin/develop/doc/images/index.png)\n\nThere are four ways to deploy Dubbo Admin to a production environment.\n\n1. [Compile from source](#11-compile-from-source)\n2. [Run with Docker](#12-run-with-docker)\n3. [Run with Kubernetes](#13-run-with-kubernetes)\n4. [Run with Helm](#14-run-with-helm)\n\nChoose either method based on your environment, where Helm is the recommended installation method because Helm can be installed with a single click and automatically helps manage all of Admin's required production environment dependencies.\n\n## 1.1 Compile from source\n\n1. Download code: `git clone https://github.com/apache/dubbo-admin.git`\n2. Change `dubbo-admin-server/src/main/resources/application.properties` configuration to make Admin points to the designated registries, etc.\n3. Build\n    - `mvn clean package -Dmaven.test.skip=true`\n4. Start\n    * `mvn --projects dubbo-admin-server spring-boot:run`\n      or\n    * `cd dubbo-admin-distribution/target; java -jar dubbo-admin-${project.version}.jar`\n5. Visit  `http://localhost:38080`, default username and password are `root`\n\n\u003e **Security Notice: Please remember to change the `admin.check.signSecret`, `admin.root.user.name` and `admin.root.user.password` value before you deploy to production environment.**\n\n## 1.2 Run with Docker\n\n\u003e **Note: This method only supports running under linux system. Docker support for windows and mac systems will be released soon!**\n\nDubbo-Admin image is hosted at： https://hub.docker.com/repository/docker/apache/dubbo-admin.\n\nYou can run the image directly by mounting a volume from the host that contains an `application.properties` file with the accessible registry and config-center addresses specified.\n\n```shell\n$ docker run -itd --net=host --name dubbo-admin -v /dubbo/dubbo-admin/properties:/config apache/dubbo-admin\n```\n\n\u003e Replace `/dubbo/dubbo-admin/properties` with the actual host path (must be an absolute path) that points to a directory containing `application.properties`.\n\nThe `application.properties` configuration file is as follows (taking the `zookeeper` registration center as an example):\n\n```properties\nadmin.registry.address=zookeeper://127.0.0.1:2181\nadmin.config-center=zookeeper://127.0.0.1:2181\nadmin.root.user.name=root\nadmin.root.user.password=root\nadmin.check.signSecret=86295dd0c4ef69a1036b0b0c15158d77\n```\n\n\u003e **Security Notice: Please remember to change the `admin.check.signSecret`, `admin.root.user.name` and `admin.root.user.password` value before you deploy to production environment.**\n\nOpen web browser and visit `http://localhost:38080`, default username and password are `root`.\n\n## 1.3 Run with Kubernetes\n\n**1. Download Kubernetes manifests**\n```sh\n$ git clone https://github.com/apache/dubbo-admin.git\n```\n\nSwitch to the 'dubbo-admin/kubernetes/dubbo-admin' directory to see the Admin kubernetes resource file\n```sh\n$ cd dubbo-admin/kubernetes/dubbo-admin\n```\n\n**2. Install Dubbo Admin**\n\nOpen `configmap.yaml` and modify accordingly to override configurations in [application.properties](./dubbo-admin-server/src/main/resources/application.properties).\n\n\u003e **Security Notice: Please remember to change the `admin.check.signSecret`, `admin.root.user.name` and `admin.root.user.password` value before you deploy to production environment.**\n\nRun the following command:\n\n```sh\n$ kubectl apply -f ./\n```\n\n**3. Visit Admin**\n```sh\n$ kubectl port-forward service dubbo-admin 38080:38080\n```\n\nVisit `http://localhost:38080`\n\n\n## 1.4 Helm with Admin\nThere are two ways to run Admin through Help. They have the same effect, so you can choose any of the following.\n\n**1. Download chart source file**\n\nclone Dubbo Admin project storehouse:\n\n```sh\n$ git clone https://github.com/apache/dubbo-admin.git\n```\n\nSwitch from the warehouse root directory to the following directory `deploy/charts/dubbo-admin`\n\n```sh\n$ cd dubbo-admin/charts/dubbo-admin\n```\n**2. Install helm chart**\n\nStart parameters of Admin so that Admin can connect to the real production environment registry or configuration center. You can specify a custom configuration file through the following `-f` help parameter:\n```yaml\nproperties:\n  admin.registry.address: zookeeper://zookeeper:2181\n  admin.config-center: zookeeper://zookeeper:2181\n  admin.metadata-report.address: zookeeper://zookeeper:2181\n  admin.root.user.name: root\n  admin.root.user.password: root\n  admin.check.signSecret: 86295dd0c4ef69a1036b0b0c15158d77\n```\n\n\u003e **Security Notice: Please remember to change the `admin.check.signSecret`, `admin.root.user.name` and `admin.root.user.password` value before you deploy to production environment.**\n\n```sh\n$ helm install dubbo-admin -f values.yaml .\n```\n\n`properties` in `values.yml` will override those defaults in Admin [application.properties](./dubbo-admin-server/src/main/resources/application.properties), In addition to 'properties', you can also customize other properties defined by Admin chart, check here for [Complete parameters](./charts/helm/dubbo-admin/values.yaml)。\n\n**3. Visit Admin**\n\nVisit http://127.0.0.1:38080\n\n# 2. Want To Contribute\n\nBelow contains the description of the project structure for developers who want to contribute to make Dubbo Admin better.\n\n## 2.1 Admin UI\n\n- [Vue.js](https://vuejs.org) and [Vue Cli](https://cli.vuejs.org/)\n- [dubbo-admin-ui/README.md](dubbo-admin-ui/README.md) for more detail\n- Set npm **proxy mirror\nBelow contains the description of the project structure for developers who want to contribute to make Dubbo Admin better.\n\n## 2.1 Admin UI\n\n- [Vue.js](https://vuejs.org) and [Vue Cli](https://cli.vuejs.org/)\n- [dubbo-admin-ui/README.md](dubbo-admin-ui/README.md) for more detail\n- Set npm **proxy mirror**:\n\n  If you have network issue, you can set npm proxy mirror to speedup npm install:\n\n  add `registry=https://registry.npmmirror.com` to ~/.npmrc\n\n## 2.2 Admin Server\n\n* Standard spring boot project\n* [configurations in application.properties](https://github.com/apache/dubbo-admin/wiki/Dubbo-Admin-configuration)\n\n\n## 2.3 Setting up a local developing environment\n* Run admin server project\n\n  backend is a standard spring boot project, you can run it in any java IDE\n\n* Run admin ui project\n\n  at directory `dubbo-admin-ui`, run with `npm run dev`.\n\n* visit web page\n\n  visit `http://localhost:38082`, frontend supports hot reload.\n\n# 3 License\n\nApache Dubbo admin is under the Apache 2.0 license, Version 2.0.\nSee [LICENSE](https://github.com/apache/dubbo-admin/blob/develop/LICENSE) for full license text.\n","funding_links":[],"categories":["Go","DevOps"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fdubbo-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fdubbo-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fdubbo-admin/lists"}