Container management solution with an accent on modeling containerized applications and provide placement based on dynamic policy allocation
Java JavaScript HTML Go TypeScript CSS Other
Clone or download
iilieva Change text of nav item for Clusters for VRA and Standalone to 'Conta…
…iner Host Clusters'.

Change-Id: Ica5c668aff131959a12a7f721c9b533eda41412e
Reviewed-on: https://bellevue-ci.eng.vmware.com:8080/41377
Closures-Verified: jenkins <jenkins@vmware.com>
Upgrade-Verified: jenkins <jenkins@vmware.com>
PG-Verified: jenkins <jenkins@vmware.com>
Bellevue-Verified: jenkins <jenkins@vmware.com>
CS-Verified: jenkins <jenkins@vmware.com>
Reviewed-by: Iveta Ilieva <iilieva@vmware.com>
Latest commit e8c0af9 Aug 10, 2018
Permalink
Failed to load latest commit information.
adapter Bump xenon to latest and add postgres Aug 10, 2018
auth Bump xenon to latest and add postgres Aug 10, 2018
cli TestAddAndUpdateHostWithTags ignore. Apr 20, 2018
closures Bump xenon to latest and add postgres Aug 10, 2018
common-test Bump xenon to latest and add postgres Aug 10, 2018
common Bump xenon to latest and add postgres Aug 10, 2018
compute Bump xenon to latest and add postgres Aug 10, 2018
container-images Change photon repo path Jul 20, 2018
contrib Add support for range of years in headers Jan 19, 2017
host Bump xenon to latest and add postgres Aug 10, 2018
photon Bump xenon to latest and add postgres Aug 10, 2018
rdbms Bump xenon to latest and add postgres Aug 10, 2018
request Bump xenon to latest and add postgres Aug 10, 2018
test-closure-integration Bump admiral to version 1.4.2-SNAPSHOT Jul 2, 2018
test-closure-performance Bump admiral to version 1.4.2-SNAPSHOT Jul 2, 2018
test-e2e Add test for registries Aug 8, 2018
test-integration Bump xenon to latest and add postgres Aug 10, 2018
test-performance Fix jmeter queries for perfomance tests. Feb 6, 2017
test-upgrade Bump xenon to latest and add postgres Aug 10, 2018
test-uptime Bump admiral to version 1.4.2-SNAPSHOT Jul 2, 2018
tiller Bump xenon to latest and add postgres Aug 10, 2018
tools/build Add support for range of years in headers Jan 19, 2017
ui Change text of nav item for Clusters for VRA and Standalone to 'Conta… Aug 13, 2018
upgrade Bump xenon to latest and add postgres Aug 10, 2018
.drone.yml Update drone yml file to work with the new HaaS infrastructure Feb 28, 2018
.gitattributes Convert to all text files from CRLF to LF Jul 20, 2017
.gitignore Fix race condition when host is stopping May 23, 2017
.gitmodules Optimize cli build, use submodules for deps May 3, 2017
CHANGELOG.md Bump admiral to version 1.4.0-SNAPSHOT May 3, 2018
CONTRIBUTING.md Add CONTRIBUTING template Aug 22, 2016
LICENSE Adding license for version 1.4.1 Jun 29, 2018
NOTICE Adding license and notice for 1.3.1 Feb 28, 2018
README.md Minor fixes to properly display README.md content in github. May 18, 2017
admiral.l10n UI is not translated in pt_BR, zh_CN and zh_TW Sep 15, 2017
pom-e2e.xml Bump admiral to version 1.4.2-SNAPSHOT Jul 2, 2018
pom-integration.xml Bump admiral to version 1.4.2-SNAPSHOT Jul 2, 2018
pom-performance.xml Show full stack traces Jun 13, 2017
pom.xml Bump xenon to latest and add postgres Aug 10, 2018

README.md

Admiral

Admiral

Contents

What is Admiral?

Admiral™ 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.

This 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.

Admiral is a service written in Java and based on VMware's Xenon framework. This service enables the users to:

  • manage Docker hosts, where containers will be deployed
  • manage Policies (together with Resource Pools, Deployment Policies, etc.), to establish the preferences about what host(s) a container deployment will actually use
  • manage Templates (including one or more container images) and Docker Registries
  • manage Containers and Applications
  • manage other common and required entities like credentials, certificates, etc.

Getting started

Running Admiral

There are three ways you can start Admiral:

1. Run container image

docker run -d -p 8282:8282 --name admiral vmware/admiral

Open http://<docker-host-IP>:8282 in browser...Configure Docker Host

Note Due to the significant amount of logs generated it is advisable to include docker log parameters:

--log-driver=json-file --log-opt max-size=1g --log-opt max-file=10

This sample parameters added to docker run command will keep 10 files of 1GB each. Tune according your needs.

2. Download the published build archive, you can find it in 'Downloads' section here.

java -jar admiral-host-*-uber-jar-with-agent.jar --bindAddress=0.0.0.0 --port=8282

Open http://127.0.0.1:8282 in browser...Configure Docker Host

3. Clone the repo and build locally. Detailed instructions about building locally can be found in the Admiral developer guide:

  • Building the Admiral agent first (to achieve smaller image file size an LZMA2 compression is used, you need xz utils )
cd container-images/admiral-agent
make buildall
  • Building the Java project
mvn clean install -DskipTests
  • Run the project
java -jar host/target/admiral-host-*-jar-with-dependencies-and-agent.jar --bindAddress=0.0.0.0 --port=8282

Open http://127.0.0.1:8282 in browser...Configure Docker Host

Building the code

mvn clean install

More info on Admiral wiki

Contributing

You 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. For any questions about the CLA process, please refer to our FAQ.

Before you start to code, we recommend discussing your plans through a GitHub issue or discuss it first with the official project maintainers via the gitter.im chat or project-admiral forum, 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.

License

Admiral is available under the Apache 2 license.

This 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:

Admiral wiki