minor badge fix

add badges

- build badge
- maven central badge

update documentation

Add info about
- adding service properties
- making prototype scoped services
- auto properties

remove mdtext version of pages

add some website instructions

tweak to test pipelines

try triggerRemoteJob from snippet generator

try unconditionally triggering the website build

try harder to get Jenkinsfile changeset selector to work

try to get Jenkinsfile changeset selector to work

small change to test build trigger

add a Jenkinsfile to trigger website build

Set up per-component/version author mode playbook; don't list indexing to console, tweaks

add new pages to nav

add pages from published site missing from CMS, make javadoc links work

primitive embedding of html pages in adoc, change broken links to working xrefs

Make nav match directory structure

convert tables from psuedo escaped html to asciidoc

basic adoc cleanup

add antora.yml, nav.adoc, temporary auto-index.adoc

initial kramdoc conversion to asciidoc

move to basic antora structure

jaxrs, rsa, container projects

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1847282 13f79535-47bb-0310-9956-ffa450edef68

update to R7

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1847127 13f79535-47bb-0310-9956-ffa450edef68

update site

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1838881 13f79535-47bb-0310-9956-ffa450edef68

July board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1835756 13f79535-47bb-0310-9956-ffa450edef68

July report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1835755 13f79535-47bb-0310-9956-ffa450edef68

initial July2018  board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1835743 13f79535-47bb-0310-9956-ffa450edef68

Add Grzegorz Grzybek and Carlos Sierra Andres as committers and PMC members. Add Raymond Auge as PMC member.

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1834987 13f79535-47bb-0310-9956-ffa450edef68

CMS commit to aries by alien11689

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1831797 13f79535-47bb-0310-9956-ffa450edef68

link to the April board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1828646 13f79535-47bb-0310-9956-ffa450edef68

report for April

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1828633 13f79535-47bb-0310-9956-ffa450edef68

initial April board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1828629 13f79535-47bb-0310-9956-ffa450edef68

Described the warning.exceptions property.

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1822510 13f79535-47bb-0310-9956-ffa450edef68

Board report for January 2018

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1820767 13f79535-47bb-0310-9956-ffa450edef68

initial Jan 2018 board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1820765 13f79535-47bb-0310-9956-ffa450edef68

Add link to Jan 2018 report and missing link to Oct 2017

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1820764 13f79535-47bb-0310-9956-ffa450edef68

CMS commit to aries by jutzig

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1815992 13f79535-47bb-0310-9956-ffa450edef68

Add information about new annotations for blueprint maven plugin

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1812438 13f79535-47bb-0310-9956-ffa450edef68

October report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1811848 13f79535-47bb-0310-9956-ffa450edef68

Start October 2017 board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1811836 13f79535-47bb-0310-9956-ffa450edef68

adding new report to index

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1801759 13f79535-47bb-0310-9956-ffa450edef68

CMS move to july-2017.mdtext by hughesj

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1801758 13f79535-47bb-0310-9956-ffa450edef68

CMS move to may-2017.mdtext by hughesj

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1801757 13f79535-47bb-0310-9956-ffa450edef68

CMS move to july-2017-new.mdtext by hughesj

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1801756 13f79535-47bb-0310-9956-ffa450edef68

CMS move to july-2017.mdtext by hughesj

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1801755 13f79535-47bb-0310-9956-ffa450edef68

July report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1801754 13f79535-47bb-0310-9956-ffa450edef68

Add new board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1801750 13f79535-47bb-0310-9956-ffa450edef68

Update source links

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1798841 13f79535-47bb-0310-9956-ffa450edef68

Add alien11689 to PMC

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1797004 13f79535-47bb-0310-9956-ffa450edef68

Aries Containers documentation editorial updates

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796872 13f79535-47bb-0310-9956-ffa450edef68

OSGi Example

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796869 13f79535-47bb-0310-9956-ffa450edef68

Resize image.

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796863 13f79535-47bb-0310-9956-ffa450edef68

OSGi Example

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796833 13f79535-47bb-0310-9956-ffa450edef68

OSGi Example

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796832 13f79535-47bb-0310-9956-ffa450edef68

Add screenshot.

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796831 13f79535-47bb-0310-9956-ffa450edef68

OSGi Example

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796830 13f79535-47bb-0310-9956-ffa450edef68

Initial documentation for Aries Containers OSGi example

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796653 13f79535-47bb-0310-9956-ffa450edef68

# Aries Containers
Aries Containers is a project to manage container deployment, such as docker containers, from a Java API.

Many technologies exist to manage container deployments. Examples include Kubernetes, Marathon/Mesos, Docker Swarm, Amazon ECS
and others. While each technology provides specific features, many of these management technologies share common behaviour.
Aries Containers provides an abstraction that allows users to easily switch between these technologies.

Benefits:

  - Requirements change - container users may find that they need to change target platforms at short notice. Using an abstraction API
helps making such changes without too much additional work.
  - Testing - many container management systems require cluster of machines or otherwise large setup which may make testing during
development difficult. Aries Containers also contains a `docker.local` binding which makes it possible to run the same code with a different
binding on a local developer machine, as long as docker is installed there.

Current modules:

  - `containers-api` - the API implemented by the various bindings.
  - `containers-docker-local` - Binding that uses the local docker installation.
  - `containers-marathon` - Marathon binding.
  - `containers-parent` - Parent pom.
  - `containers-examples` - Examples.
  - ...

This project may be used as input to the design process of the [OSGi RFP 179][1].

# Source
The Aries RSA source is in a separate [git repository aries-containers][2] there is also a [mirror on github][3].

To build the source, just run:

`mvn install`

Java 1.8 or higher is required. Maven 3.3.9+ is recommended.

# Quick Start
The easiest way to get started is with the examples and the local docker binding. Aries Containers work well in an OSGi
environment where bindings are provided as OSGi services.

As an alternative, Aries Containers can also be used in a plain Java environment. Instead of obtaining the bindings
from the service registry, they need to be instantiated directly in this case.

This quick start focuses on a number of examples to suit your environment.

## OSGi example

## Plain Java example

This example launches a small Java Application to create a service deployment. Initially a single container is deployed. The user can
modify the number of replicas using the application.

The code can be found here: [Main.java][4]

The main functionality is:

            ServiceManager sm = new LocalDockerServiceManager();

            // If you want to run with Marathon, use the following line
            // ServiceManager sm = new MarathonServiceManager("http://192.168.99.100:8080/");

            ServiceConfig sc = ServiceConfig.builder("mytesthttpd", "httpd").
                cpu(0.2).memory(32).port(80).build();
            Service svc = sm.getService(sc);
            // The service is now created

If you are running this the Docker local binding, you can see the docker container created:

    $ docker ps
    CONTAINER ID        IMAGE               COMMAND              STATUS              PORTS                   NAMES
    7cc5c753777e        httpd               "httpd-foreground"   Up 4 seconds        0.0.0.0:51467->80/tcp   mytesthttpd

The example also allows scaling up and down of replica containers for this service.

#Bindings

##Docker Local

This binding works by issuing `docker` commands on the local machine and is very useful for testing. Make sure the environment
variables normally provided via `docker-machine env <myenv>` are set.

OSGi ServiceManager identifier: `container.factory.binding = docker.local`

Constructor, for use outside of OSGi: `org.apache.aries.containers.docker.local.impl.LocalDockerServiceManager`

##Marathon

This binding uses Marathon as the underlying container manager. It requires the following configuration to be set:

    service.pid: org.apache.aries.containers.marathon
      marathon.url=<the URL where marathon can be contacted>

Once configured, the Marathon binding will register its OSGi service.
OSGi ServiceManager identifier: `container.factory.binding = marathon`

Constructors, for use outside of OSGi: `org.apache.aries.containers.marathon.impl.MarathonServiceManager`

    /**
     * Create the Marathon Service Manager.
     *
     * @param marathonURL The Marathon URL
     */
    public MarathonServiceManager(String marathonURL);

    /**
     * Create the Marathon Service Manager for use with DC/OS.
     *
     * @param marathonURL The Marathon URL.
     * @param dcosUser The DCOS user or service-user.
     * @param passToken The password or token to use.
     * @param serviceAcct `true` if this is a service account `false` if this is a plain user.
     */
    public MarathonServiceManager(String marathonURL, String dcosUser, String passToken, boolean serviceAcct);

  [1]: https://github.com/osgi/design/blob/master/rfps/rfp-0179-ComputeManagementService.pdf
  [2]: https://git-wip-us.apache.org/repos/asf/aries-containers.git
  [3]: https://github.com/apache/aries-containers
  [4]: https://git-wip-us.apache.org/repos/asf?p=aries-containers.git;a=blob;f=containers-examples/containers-example-javaapp/src/main/java/org/apache/aries/containers/examples/javaapp/Main.java;h=0f06a304fc5ec96ce3f50e6af338b5b320d901d1;hb=HEAD

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796650 13f79535-47bb-0310-9956-ffa450edef68

Aries Containers add some documentation for local docker and marathon bindings.

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796648 13f79535-47bb-0310-9956-ffa450edef68

Initial documentation for Aries Containers

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796644 13f79535-47bb-0310-9956-ffa450edef68

Initial template for Aries Containers documentation.

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796295 13f79535-47bb-0310-9956-ffa450edef68

Add empty documentation template for Aries Containers subproject.

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1796294 13f79535-47bb-0310-9956-ffa450edef68

Add May 2017 report to index

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1794738 13f79535-47bb-0310-9956-ffa450edef68

Some minor updates

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1794737 13f79535-47bb-0310-9956-ffa450edef68

Board report copied from https://cwiki.apache.org/confluence/display/ARIES/Board+Report+May+2017

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1794736 13f79535-47bb-0310-9956-ffa450edef68

Added Raymond and Tom

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1793678 13f79535-47bb-0310-9956-ffa450edef68

CMS commit to aries by cschneider

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1791783 13f79535-47bb-0310-9956-ffa450edef68

Add missing spring dependency and add note about optional annotations

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1782629 13f79535-47bb-0310-9956-ffa450edef68

Fix css

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1780570 13f79535-47bb-0310-9956-ffa450edef68

Fix styling

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1780566 13f79535-47bb-0310-9956-ffa450edef68

Added link to new board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1778465 13f79535-47bb-0310-9956-ffa450edef68

Report for Jan 2017

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1778464 13f79535-47bb-0310-9956-ffa450edef68

initial report copied from October

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1778446 13f79535-47bb-0310-9956-ffa450edef68

Update blueprint maven plugin page for version 1.5.0

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1775333 13f79535-47bb-0310-9956-ffa450edef68

Correct link to DOSGi

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1764926 13f79535-47bb-0310-9956-ffa450edef68

add link to october report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1764737 13f79535-47bb-0310-9956-ffa450edef68

board report for oct 2016

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1764735 13f79535-47bb-0310-9956-ffa450edef68

Updated plugin configs

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1755588 13f79535-47bb-0310-9956-ffa450edef68

Finishing up

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1752470 13f79535-47bb-0310-9956-ffa450edef68

added info from reporter.apache.org

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1752315 13f79535-47bb-0310-9956-ffa450edef68

Initial july 2016 report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1752309 13f79535-47bb-0310-9956-ffa450edef68

Add July board report

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1752308 13f79535-47bb-0310-9956-ffa450edef68

Update for first release

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1750889 13f79535-47bb-0310-9956-ffa450edef68

CMS commit to aries by alien11689

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1746090 13f79535-47bb-0310-9956-ffa450edef68

Add link to Spring tx

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1744757 13f79535-47bb-0310-9956-ffa450edef68

Add a page describing Spring migration and problems with proxies

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1744756 13f79535-47bb-0310-9956-ffa450edef68

Add a link to Exception Management in the quick start

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1744546 13f79535-47bb-0310-9956-ffa450edef68

Add an Exception Management page

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1744294 13f79535-47bb-0310-9956-ffa450edef68

Fill in TODOs for the Transaction Control Service.

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1743006 13f79535-47bb-0310-9956-ffa450edef68

CMS commit to aries by cschneider

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1742224 13f79535-47bb-0310-9956-ffa450edef68

CMS commit to aries by cschneider

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1742223 13f79535-47bb-0310-9956-ffa450edef68

CMS commit to aries by cschneider

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1742222 13f79535-47bb-0310-9956-ffa450edef68

Add coordinator and last resource gambit documentation

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1741488 13f79535-47bb-0310-9956-ffa450edef68

Add JPA implementation documentation

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1741482 13f79535-47bb-0310-9956-ffa450edef68

Links to modules from the root page

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1741467 13f79535-47bb-0310-9956-ffa450edef68

Add Documentation for the JDBC Provider implementations

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1741462 13f79535-47bb-0310-9956-ffa450edef68

Add descriptions for the Local and XA Transaction Control service implementations

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1741429 13f79535-47bb-0310-9956-ffa450edef68

Document the provisional nature of the OSGi API

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1741413 13f79535-47bb-0310-9956-ffa450edef68

Add links to tx-control quick start and advanced topics

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1741201 13f79535-47bb-0310-9956-ffa450edef68