winery

Eclipse Winery Toolchain

To contribute to Eclipse Winery development you need a GitHub account and access to https://github.com/opentosca/winery. Email your supervisor your GitHub username.

Install Apache Maven

Get Apache Maven to run.

Get write access to the code repositories

  1. Email your supervisor your GitHub username and your development email address.
  2. Your supervisor adds you to the team “developers” at https://github.com/opentosca and https://github.com/winery.
  3. You will receive two emails from GitHub asking for your confirmation.
  4. Open the link https://github.com/orgs/winery/invitation.
  5. Open the link https://github.com/orgs/OpenTOSCA/invitation.

Steps to initialize the code repository

  1. Clone https://github.com/opentosca/winery (it automatically becomes the origin).
    • We recommend that git repositories reside in c:\git-repositories.
    • Use ConEmu as a program for all your shells: choco install conemu. Install chocolatey to use the choco command.
    • Execute git clone https://github.com/OpenTOSCA/winery.git in c:\git-repositories.
  2. Change into the newly created directory winery: cd winery.
  3. Add upstream as second remote: git remote add upstream https://github.com/eclipse/winery.git
  4. Fetch everything from upstream: git fetch upstream or git fetch --all
  5. Run mvn clean install -DskipTests to build the whole project

Steps to initialize a TOSCA repository

Winery has built-in magic to check for existence of c:/winery-repository on Windows. If that directory exists, this is used as repository location. If that directory does not exists, it uses the home directory, which is %HOME% defaulting to c:/Users/<USERNAME>/winery-repository (or ~/winery-repository on Linux-based operating systems).

However, you can start Winery based on an existing repository.

XML Repo: https://github.com/OpenTOSCA/tosca-definitions-internal YAML Repo: https://github.com/radon-h2020/radon-particles

  1. Clone one the repositories from above
  2. Start the Winery backend to initialize the configuration files
  3. Go to C:\Users\<your user>\.winery on your computer and open the file winery.yml
  4. Adjust the value of the provider and repositoryRoot attribute:

    provider: file
    repositoryRoot: c:\git-repositories\tosca-definitions-internal
    

    or

    provider: yaml
    repositoryRoot: c:\git-repositories\radon-particles
    
  5. Restart your Winery backend

Steps to initialize the IDE

Setup IntelliJ IDEA as described at config/IntelliJ IDEA. Alternatively, you can you Eclipse as described at config/Eclipse. However, the latter is currently work-in-progress.