Skip to main content

Manage Application Composition Projects

Application Composition Projects are used to compose applications based on already existing, reusable components from a repository. An application is just a representation of deployment instructions and configurations for multiple components that will get deployed together, but there is no "implementation code" as there is in service projects.

Create new projects​

You can create new application projects by clicking on the "Create" button on the Projects overview page and providing the following information:

  • In the "Create Project" dialog choose Application Composition Project
  • Specify a unique acronym for this project
  • Give the application a name
  • Select the Git provider that should be used to store the project's source code
  • Choose a repository group at this Git provider
  • Choose one or more tags (optional)
  • Choose an icon (optional)
  • Enter a description of your application (optional)
  • Click on create

Now that you have a new application composition project you need to add at least one deployment target before you can start adding components.

  • Click on "Add deployment target"
  • Select a namespace from the drop-down (you will see all configured deployment targets)

After having added deployment targets you can start adding components by clicking on the "+" button.

Read more about managing application composition projects.

Delete application composition projects​

To delete an application composition project you just have to click on the trash icon in the right upper corner inside an application project. You will be prompted with a confirmation screen where you have to type the acronym of the application to delete it.

ℹ️note

Delete is only shown if the user has the needed privileges granted in the Git repository.

The documentation section​

Every project built with IBM Industry Solutions Workbench provides a documentation section and so do application composition projects. The built-in Markdown editor lets you write extensive documentation in a WYSIWYG or text mode with support for text formatting, links, tables and code-blocks. The text editor supports both CommonMark and GitHub Flavored Markdown (GFM) specifications.

Besides that, there is a built-in diagram generator that renders UML diagrams using the plantUML language. To draw a diagram you have two options:

WYSIWYG mode:

  1. Place your cursor where you want to insert a diagram
  2. In the menu bar of the text editor click on "CB" (code block) to create a new code block at the cursor position
  3. On the right side of the line with the code block there will appear a button called "Editor" - click on it
  4. This will open a new CodeBlock Editor window
  5. Select plantuml from the Choose language dropdown menu on the top of the window
  6. This will start the diagram renderer, and you can start creating your UML diagram with live preview
  7. When you're done, click on "OK" to save your diagram

Markdown mode:

  1. Place your cursor where you want to insert a diagram
  2. Type three back-ticks followed by "PlantUML": ```plantuml
  3. This will start the diagram renderer, and you can start creating your UML diagram with live preview
  4. When you're done, hit "Enter" to create a new line and enter three back-ticks again to close the UML renderer
💡tip

Please see the official PlantUML Language Reference Guide for extensive description on how to draw PlantUML diagrams.

Course Application Composition