Getting Started

Launching with Docker

Note

It is recommended that your host or virtual machine has at least 2GB of memory.

Open a command prompt and execute the following command:

docker run -it -p 8080:8080 \
  -e PUBLIC_HOSTNAME=localhost \
  -e WINERY_FEATURE_RADON=true \
  -e WINERY_REPOSITORY_PROVIDER=yaml \
  -e WINERY_REPOSITORY_URL=https://github.com/radon-h2020/radon-particles \
  opentosca/radon-gmt

Launch a browser: http://localhost:8080.

Note

To start Eclipse Winery based on an TOSCA XML repository layout, use the following command:

docker run -it -p 8080:8080 \
  -e PUBLIC_HOSTNAME=localhost \
  -e WINERY_REPOSITORY_URL=https://github.com/OpenTOSCA/tosca-definitions-public \
  opentosca/winery

Note

Make sure you regularly pull the latest images:

docker pull opentosca/radon-gmt:latest
# or
docker pull opentosca/winery:latest

Use a custom TOSCA model repository

Problem: You want to use an existing TOSCA model repository that you have cloned, e.g., to add new or adapt existing TOSCA types and blueprints in this Git repository.

Please follow the next instructions to mount an existing TOSCA model repository into the Eclipse Winery container. This is useful if you want to save your modeling changes onto your Docker host machine.

Clone or create git repository on your local filesystem, e.g., by cloning https://github.com/radon-h2020/radon-particles.

Open a command prompt and execute the following command:

Warning

Replace <path_on_your_host> with the respective dirctory path on your host system.

docker run -it -p 8080:8080 \
  -e PUBLIC_HOSTNAME=localhost \
  -e WINERY_FEATURE_RADON=true \
  -e WINERY_REPOSITORY_PROVIDER=yaml \
  -v <path_on_your_host>:/var/repository \
  -u `id -u` \
  opentosca/radon-gmt

Launch a browser: http://localhost:8080.

Any change (create service template, modify or create node types) will be reflected on your host machine. You are now able to commit your changes and push them to your own Git remote (e.g., using git push from a command-prompt).

Note

To start Eclipse Winery based on an TOSCA XML repository layout, use the following command:

docker run -it -p 8080:8080 \
  -e PUBLIC_HOSTNAME=localhost \
  -v <path_on_your_host>:/var/repository \
  opentosca/winery

Model and version your applications and company-specific types only

Problem: You want to model applications based on actively maintained TOSCA type repositories but you want to version/save only your own application blueprints and company-specific types inside your (private) Git repository (GitHub, GitLab).

You are able to start Eclipse Winery in a so-called “multi-repository” setup where you can add several TOSCA type repositories that you can use for your application models. However, with this setup, Eclipse Winery creates a specific “workspace” that only contains your company-specific types and application blueprints (separated by namespace). You can then mount the created “workspace” to save your modeling results to your own Git remote.

Open a command prompt and execute the following command:

Warning

Replace <path_on_your_host> with a respective dirctory path on your host system.

docker run -it -p 8080:8080 \
  -e PUBLIC_HOSTNAME=localhost \
  -e WINERY_FEATURE_RADON=true \
  -e WINERY_REPOSITORY_PROVIDER=yaml \
  -e WINERY_DEPENDENT_REPOSITORIES="[ { \"name\" : \"RADON Particles\", \"url\" : \"https://github.com/radon-h2020/radon-particles.git\", \"branch\" : \"master\" } ]" \
  -v <path_on_your_host>:/var/repository \
  -u `id -u` \
  opentosca/radon-gmt

Your created TOSCA service templates or company-specific TOSCA node types will be stored on your host machine. You are now able to commit your changes and push them to your own Git remote (e.g., using git push from a command-prompt).

Launching with Docker Compose

Note

It is recommended that your host or virtual machine has at least 2GB of memory.

Install Docker and Docker Compose.

Clone the repository:

git clone https://github.com/eclipse/winery
cd winery/deploy/compose

[Optional] Adapt the Docker Compose configuration to your needs, e.g., to mount a local TOSCA model repository.

Start Winery:

docker-compose up

Launch a browser: http://localhost:8080.