A while ago I started on adding support for the german IaaS-provider gridscale to the golang library libretto.

libretto is used to orchestrate various IaaS-solutions such as Azure, AWS, Google Cloud Platform, on-premise solutions such as OpenStack and others. For a complete list take a look at the README.

Until the support for gridscale has been accepted and merged upstream the most current version of the code is at my github page in the feature/add-basic-gridscale-support branch.

If you want to use it, make sure to import libretto from there (checkout via git, with switching to the correct branch in your $GOPATH). If that is too difficult for you, you can also grab the source from my gitea instance. The default branch there is set to the feature/add-basic-gridscale-support branch:

import (

Design of the gridscale API

The API of gridscale is nicely structured. The top-most elements are the ressources - servers (instances) being ressources themselves that can be combined with other ressources via relations.

A typical server looks in json like this. For the sake of not leaking infos I’m not quoting the object_uuids and such.

 "server": {
    "location_country": "de",
    "relations": {
      "networks": [
		  "object_uuid": ...
      "storages": [
          "object_name": "contract-template Storage",
          "object_uuid": "2fb14084-588b-43da-88a2-240489c6f91a",
      "isoimages": [],
      "public_ips": [
          "object_uuid": "b3671913-12f4-4015-8357-2269edf3a4a8",
          "ip": "",
    "location_uuid": "45ed677b-3702-4b36-be2a-a2eab9827950",
    "name": "name of server",
    "status": "active",
    "object_uuid": ...,
    "cores": 2,
    "power": true,
    "availability_zone": null,
    "usage_in_minutes_cores": 0,
    "usage_in_minutes_memory": 9396,
    "legacy": false,
    "auto_recovery": true,
    "labels": [],
    "memory": 4,
    "location_iata": "fra",
    "location_name": "de/fra",

Each of the endpoints can be crawled and the endpoints below the resources all resemble the same design and methodology. That makes it quite easy to wip up some [generic code] to handle them. I chose the following approach:

  • added generic endpoint crawler in util.go
  • added specific functions to each of the corresponding elements, example: ip.go or storage.go.
  • in storage.go one can see what kind of other functions can be added (GetStorageByUUID())

The README states on how to use them.

Blog RSS feed
Read more posts in this category
blog archive
All available categories