{"id":13446702,"url":"https://github.com/vmware-archive/admiral","last_synced_at":"2025-12-15T22:20:01.355Z","repository":{"id":43923743,"uuid":"66285950","full_name":"vmware-archive/admiral","owner":"vmware-archive","description":"Container management solution with an accent on modeling containerized applications and provide placement based on dynamic policy allocation","archived":true,"fork":false,"pushed_at":"2021-08-21T10:11:53.000Z","size":34116,"stargazers_count":255,"open_issues_count":60,"forks_count":65,"subscribers_count":32,"default_branch":"master","last_synced_at":"2024-12-19T00:03:21.450Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vmware-archive.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-22T15:49:01.000Z","updated_at":"2024-11-11T05:28:11.000Z","dependencies_parsed_at":"2022-09-14T15:12:09.138Z","dependency_job_id":null,"html_url":"https://github.com/vmware-archive/admiral","commit_stats":null,"previous_names":["vmware/admiral"],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware-archive%2Fadmiral","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware-archive%2Fadmiral/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware-archive%2Fadmiral/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vmware-archive%2Fadmiral/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vmware-archive","download_url":"https://codeload.github.com/vmware-archive/admiral/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244829624,"owners_count":20517346,"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":[],"created_at":"2024-07-31T05:00:57.518Z","updated_at":"2025-12-15T22:20:01.308Z","avatar_url":"https://github.com/vmware-archive.png","language":"Java","funding_links":[],"categories":["Container Operations"],"sub_categories":["User Interface"],"readme":"![Admiral](https://vmware.github.io/admiral/images/admiral.png \"VMware Admiral\")\n\n# Admiral\n\n### Contents\n- [What is Admiral](#what-is-admiral)\n- [Getting started](#getting-started)\n- [Contributing](#contributing)\n- [License](#license)\n\n## What is Admiral?\n\nAdmiral™ is a highly scalable and very lightweight Container Management platform for deploying and managing container based applications. It is designed to have a small footprint and boot extremely quickly. Admiral™ is intended to provide automated deployment and lifecycle management of containers.\n\nThis container management solution can help reduce complexity and achieve advantages including simplified and automated application delivery, optimized resource utilization along with business governance and applying business policies and overall data center integration.\n\nAdmiral is a service written in Java and based on VMware's [Xenon framework](https://github.com/vmware/xenon/). This service enables the users to:\n- manage Docker hosts, where containers will be deployed\n- manage Policies (together with Resource Pools, Deployment Policies, etc.), to establish the preferences about what host(s) a container deployment will actually use\n- manage Templates (including one or more container images) and Docker Registries\n- manage Containers and Applications\n- manage other common and required entities like credentials, certificates, etc.\n\n## Getting started\n\n### Running Admiral\n\nThere are three ways you can start Admiral:\n\n#### 1. Run container image\n\n```shell\ndocker run -d -p 8282:8282 --name admiral vmware/admiral\n```\nOpen `http://\u003cdocker-host-IP\u003e:8282` in browser...[Configure Docker Host](https://github.com/vmware/admiral/wiki/User-guide#configure-existing-container-docker-host)\n\n**Note** Due to the significant amount of logs generated it is advisable to include docker log parameters:\n```shell\n--log-driver=json-file --log-opt max-size=1g --log-opt max-file=10\n```\nThis sample parameters added to docker run command will keep 10 files of 1GB each. Tune according your needs.\n\n#### 2. Download the published build archive, you can find it in 'Downloads' section [here](https://bintray.com/vmware/admiral/admiral).\n\n```shell\njava -jar admiral-host-*-uber-jar-with-agent.jar --bindAddress=0.0.0.0 --port=8282\n```\nOpen `http://127.0.0.1:8282` in browser...[Configure Docker Host](https://github.com/vmware/admiral/wiki/User-guide#configure-existing-container-docker-host)\n\n#### 3. Clone the repo and build locally. Detailed instructions about building locally can be found in the [Admiral developer guide](https://github.com/vmware/admiral/wiki/Developer-Guide):\n\n* Building the Admiral agent first (to achieve smaller image file size an LZMA2 compression is used, you need [xz utils](http://tukaani.org/xz/) )\n```shell\ncd container-images/admiral-agent\nmake buildall\n```\n\n* Building the Java project\n```shell\nmvn clean install -DskipTests\n```\n\n* Run the project\n```shell\njava -jar host/target/admiral-host-*-jar-with-dependencies-and-agent.jar --bindAddress=0.0.0.0 --port=8282\n```\n\nOpen `http://127.0.0.1:8282` in browser...[Configure Docker Host](https://github.com/vmware/admiral/wiki/User-guide#configure-existing-container-docker-host)\n\n### Building the code\n\n```shell\nmvn clean install\n```\n\nMore info on [Admiral wiki](https://github.com/vmware/admiral/wiki)\n\n## Contributing\n\nYou are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can. If you wish to contribute code and you have not signed our contributor license agreement (CLA), our bot will update the issue when you open a [Pull Request](https://help.github.com/articles/creating-a-pull-request). For any questions about the CLA process, please refer to our [FAQ](https://cla.vmware.com/faq).\n\nBefore you start to code, we recommend discussing your plans through a  [GitHub issue](https://github.com/vmware/admiral/issues) or discuss it first with the official project maintainers via the [gitter.im chat](https://gitter.im/project-admiral/Lobby) or [project-admiral forum](https://groups.google.com/forum/#%21forum/project-admiral), especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.\n\n## License\n\nAdmiral is available under the [Apache 2 license](LICENSE).\n\nThis project uses open source components which have additional licensing terms.  The source files / docker images and licensing terms for these open source components can be found at the following locations:\n\n- Photon OS [docker image](https://hub.docker.com/_/photon/), [license](https://github.com/vmware/photon/blob/master/COPYING)\n\n\n[Admiral wiki](https://github.com/vmware/admiral/wiki)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmware-archive%2Fadmiral","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvmware-archive%2Fadmiral","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvmware-archive%2Fadmiral/lists"}