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.
In case you did not choose an account name, use
flastname
as pattern:f
is the lower-case first letter of your first name andlastname
is the lower-case last name.Due to open source development, your email address will get public. In case, you don’t have a public email address, we recommend creating one or use your student email address. In case you want to create a longer-lasting one, please use the GitHub username. Example:
flastname@gmail.com
.Please enable the git-hooks by executing
git config core.hooksPath .git-hooks
in the root of the repository.
Install Apache Maven¶
Get Apache Maven to run.
Get write access to the code repositories¶
Email your supervisor your GitHub username and your development email address.
Your supervisor adds you to the team “developers” at https://github.com/opentosca and https://github.com/winery.
You will receive two emails from GitHub asking for your confirmation.
Open the link https://github.com/orgs/winery/invitation.
Open the link https://github.com/orgs/OpenTOSCA/invitation.
Steps to initialize the code repository¶
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 thechoco
command.Execute
git clone https://github.com/OpenTOSCA/winery.git
inc:\git-repositories
.
Change into the newly created directory
winery
:cd winery
.Add
upstream
as second remote:git remote add upstream https://github.com/eclipse/winery.git
Fetch everything from
upstream
:git fetch upstream
orgit fetch --all
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
Clone one the repositories from above
Start the Winery backend to initialize the configuration files
Go to
C:\Users\<your user>\.winery
on your computer and open the filewinery.yml
Adjust the value of the
provider
andrepositoryRoot
attribute:provider: file repositoryRoot: c:\git-repositories\tosca-definitions-internal
or
provider: yaml repositoryRoot: c:\git-repositories\radon-particles
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.