Unfurl Cloud Standard Library README

The Unfurl Cloud Standard library is a TOSCA library that provides building blocks and abstractions for deploying applications and services. It allows you to create high-level blueprints that can work in a variety of environments and can easily be combined with other blueprints.

If you are familiar with TOSCA or Unfurl, using the Unfurl Cloud Standard library should be straightforward – it is just a collection of type that you can use when you declare your templates or your own types. If you’re not familiar with TOSCA, then take a look at our application blueprint project template for a step-by-step guide for building an application blueprint using this library.

Usage in TOSCA service templates

You can use the types and templates defined here by import like any other TOSCA import – declare it as a repository and then import individual files.

For example, in a YAML service template:

    repositories:
      std:
        url: https://unfurl.cloud/onecommons/std.git
    imports:
      - file: generic_types.yaml
        repository: std

In a Python service template, the equivalent Python import statement would be:

from tosca_repositories.std.generic_types import *

Usage on Unfurl Cloud

Unfurl Cloud uses this library to generate the catalog of types to choose when you create a resource for a deployment or for an environment in your dashboard.

This enables interoperability with applications blueprints that use this library – and nearly all Unfurl Cloud’s supported blueprints do.

You can customize which types library Unfurl Cloud uses for its types catalog by editing your dashboard’s unfurl.yaml file.

Overview and API documentation

See https://onecommons.pages.unfurl.cloud/std/