Skip to content

Getting Started

In this example, we will deploy a textfile on our local machine which has a different content depending on our input. This is just a simple example without any dependencies, such as a Docker Engine or a cloud. For a more complex scenario including OpenStack and GCP see Motivating Scenario.

First, we install OpenTOSCA Vintner. For more information see Installation.

1
curl -fsSL https://vintner.opentosca.org/install.sh | sudo bash -

We currently support xOpera and Unfurl. Since both can only be installed on Linux, we provide a WSL integration for both. We configure and enable xOpera. For more information see Installation.

1
2
vintner orchestrators init xopera
vintner orchestrators enable --orchestrator xopera

Next, we clone the repository. 

1
2
3
4
5
6
7
git clone https://github.com/OpenTOSCA/opentosca-vintner.git
cd opentosca-vintner
git lfs install
git lfs pull
./task install
./task tasks:build
./task examples:pull:link

Next, we import the Variability4TOSCA template.

1
vintner templates import --template getting-started --path examples/xopera-getting-started

Next, we initialize an application instance.

1
vintner instances init --instance getting-started --template getting-started

The imported template contains the following conditional node templates.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
first:
    type: textfile
    conditions: {logic_expression: is_first}
    properties:
        content: 'First Textfile has been selected!'
    requirements:
        - host: 
            node: localhost
            conditions: {logic_expression: is_first}

second:
    type: textfile
    conditions: {logic_expression: is_second}
    properties:
        content: 'Second Textfile has been selected!'
    requirements:
        - host: 
            node: localhost
            conditions: {logic_expression: is_second}

We intend to deploy the first textfile. We specify this when resolving variability.

1
vintner instances resolve --instance getting-started --presets first

Finally, we deploy the application.

1
vintner instances deploy --instance getting-started

The deployed textfile has the content as expected.

/tmp/vintner-getting-started.txt
1
First Textfile has been selected!

Eventually, we undeploy the application.

1
vintner instances undeploy --instance getting-started
Last update: December 13, 2024