Skip to content

Setup in Cloud Foundry

Deploy Eclipse Dirigible in the SAP Cloud Platform Cloud Foundry environment.

Prerequisites

Steps

  1. Set the SAP Cloud Platform Cloud Foundry API host:

    cf api <cloud-foundry-api-host>
    
  2. Login to the SAP Cloud Platform Cloud Foundry environment with:

    cf login
    
  3. Deploy Eclipse Dirigible:

    cf push dirigible \
    --docker-image=dirigiblelabs/dirigible-sap-cf:latest \
    --hostname dirigible-<org-name> \
    -m 2G -k 2G
    

    Note: Replace the <org-name> placeholder with your subaccount's Subdomain value.

    Eclipse Dirigible versions

    Instead of using the latest tag (version), for production and development use cases it is recomended to use stable release version:

    • All released versions can be found here.
    • All Eclipse Dirigible Docker images and tags (versions) can be found here.
  4. Create XSUAA service instance:

    • Copy and paste the following content into xs-security.json:

      {
         "xsappname": "<applicationName>-xsuaa",
         "tenant-mode": "shared",
         "scopes": [
            {
               "name": "$XSAPPNAME.Developer",
               "description": "Developer scope"
            },
            {
               "name": "$XSAPPNAME.Operator",
               "description": "Operator scope"
            }
         ],
         "role-templates": [
            {
               "name": "Developer",
               "description": "Developer related roles",
               "scope-references": [
                  "$XSAPPNAME.Developer"
               ]
            },
            {
               "name": "Operator",
               "description": "Operator related roles",
               "scope-references": [
                  "$XSAPPNAME.Operator"
               ]
            }
         ],
         "role-collections": [
            {
               "name": "dirigible",
               "description": "Dirigible Developer",
               "role-template-references": [
                  "$XSAPPNAME.Developer",
                  "$XSAPPNAME.Operator"
               ]
            }
         ]
      }
      

      Note: Replace the <applicationName> placeholder with your application name, e.g. dirigible

    • Create a XSUAA service instance:

      cf create-service xsuaa application <applicationName>-xsuaa -c xs-security.json
      

      Note: Use the same <applicationName> as in the previous step

  5. Bind the XSUAA service instance to the Eclipse Dirigible deployment:

    • Bind the service instance:

      cf bind-service dirigible <applicationName>-xsuaa
      

      Note: Replace the <applicationName> placeholder with the application name, used in the previous steps

    • Restart the dirigible deployment:

      cf restart dirigible
      
  6. Assign the Developer and Operator roles.

  7. Login.

Additional Materials

  • For deployment through manifest.yaml follow this steps.
  • Step by step tutorial can be found here.