knife-ionoscloud 6.0.0.alpha.1 → 6.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 475b719ef44823a6cb5c031100ed1b1eda199b297653f7342bb3076b73dd56b4
-  data.tar.gz: 0c662d549b3a8f3ce5144e75f1a7e46eae51c12697f14fb2ebb3758d80a0a37e
+  metadata.gz: 844d50cdb67740c66e4509ae0d8ad0a95b486c3e31558c30d54f8f96a019f4a2
+  data.tar.gz: b8fdedf4d8c42e69c33306b67580c13c6522d0c2fc5927b5430909fbd6c62d30
 SHA512:
-  metadata.gz: bace38ac3687134ca983fad4d3329b8d18c316c2ea6431a3472395b3b6ddbd9bd46e2421a620ac2ab0df85f0282559647833b9aa052b58a137468e73869790f3
-  data.tar.gz: d730abe3bdf1950fe11b970d7dc7f964ff140080d12553a0d8447e88f0b19e504da3834324afdd411c5bfa210a69d080f55eb348a6eddf053edee626c2fa8c7f
+  metadata.gz: af364bfbcaa19a9471d22f48e4261a71f941ff2584618587161da76ae4691c0830e20357354a99628661f69bd013f9f6b57f5373d8ffb4ff029ffc270caafb35
+  data.tar.gz: 4a77204a6becf7a87452921a9379a394dbf788e9ad4c3fca24ed349a03d347b7dc1ee6e8495e8c0f27c07084f5f5d1bb1bb4aaf0d9708199076a1ccfdda7b978

data/.github/IONOS.CLOUD.BLU.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1077.17 255.12"><defs><style>.cls-1{fill:#003d8f;}</style></defs><title>IONOS.CLOUD Blu</title><g id="Ebene_3" data-name="Ebene 3"><path class="cls-1" d="M594.12,211.52a42.56,42.56,0,0,1-8.5-.86,44,44,0,0,1-29-20.73l-.15-.29a13,13,0,0,1,4.8-17.2,12.55,12.55,0,0,1,6.46-1.79,12.77,12.77,0,0,1,11.12,6.54c.13.22.28.47.44.71l1.35,1.84,1.82,1.84a17.69,17.69,0,0,0,8.29,4,18.21,18.21,0,0,0,14.3-3.27,17.27,17.27,0,0,0,7.18-12.93,17.86,17.86,0,0,0-5-13.88s-38.42-39.9-40.14-41.75a47.14,47.14,0,0,1-4.63-5.51c-5.42-7.68-7.12-16.74-6.28-25.7a41.75,41.75,0,0,1,5.41-17.77s1.76-3,2.28-3.73a48.36,48.36,0,0,1,8.78-8.95A45.36,45.36,0,0,1,580,47.67a42,42,0,0,1,54.79,16.91,12.45,12.45,0,0,1,1.33,9.65,12.73,12.73,0,0,1-6.07,7.85,12.21,12.21,0,0,1-6.23,1.69,12.68,12.68,0,0,1-11.05-6.5,16.69,16.69,0,0,0-11.18-7.91,17.35,17.35,0,0,0-13.56,3,16.5,16.5,0,0,0-6.41,12,16.82,16.82,0,0,0,4.57,13l39.28,40.5a43.5,43.5,0,0,1-31.38,73.68"/><path class="cls-1" d="M469.82,211.5a42.29,42.29,0,0,1-42.24-42.24V85.7a42.24,42.24,0,1,1,84.48,0v83.56a42.29,42.29,0,0,1-42.24,42.24m0-142.53A16.76,16.76,0,0,0,453.08,85.7v83.56A16.56,16.56,0,0,0,469.82,186a16.76,16.76,0,0,0,16.74-16.73V85.7A17,17,0,0,0,469.82,69"/><path class="cls-1" d="M305.61,129.64v69.1a12.75,12.75,0,0,1-25.5,0v-122Zm69.18,48.65V56.21a12.75,12.75,0,1,0-25.5,0v69.15ZM304.57,50.69l-.12-.24a13.06,13.06,0,0,0-11.54-6.92,11.84,11.84,0,0,0-2.57.27,12.48,12.48,0,0,0-10.07,12.41v2.91L350.4,204.5a13.14,13.14,0,0,0,11.32,7,11.22,11.22,0,0,0,2.92-.37,12.5,12.5,0,0,0,9.94-12.38V196l-70-145.3"/><path class="cls-1" d="M184.67,211.5a42.29,42.29,0,0,1-42.24-42.24V85.7a42.24,42.24,0,0,1,84.48,0v83.56a42.3,42.3,0,0,1-42.24,42.24m0-142.53A16.76,16.76,0,0,0,167.93,85.7v83.56a16.74,16.74,0,0,0,33.48,0V85.7A17,17,0,0,0,184.67,69"/><path class="cls-1" d="M75.19,211.43a13.8,13.8,0,0,1-13.86-14v-140l0-.27a13.89,13.89,0,0,1,27.29-3.46c.07.24.16.59.24,1l.09.6a14.23,14.23,0,0,1,.18,2.22s0,138.3,0,139.89a13.85,13.85,0,0,1-14,14.05"/><path class="cls-1" d="M709.85,211.61c-7.39,0-14.87-5-14.87-14.64V167.21c0-9.9,7.5-15.08,14.91-15.08s14.92,5.18,14.92,15.08a4.61,4.61,0,1,1-9.22,0,5.7,5.7,0,1,0-11.39,0V197c0,5.16,4.71,5.42,5.65,5.42.59,0,5.74-.15,5.74-5.23a4.61,4.61,0,1,1,9.22,0C724.81,206.54,717.1,211.61,709.85,211.61Z"/><path class="cls-1" d="M929.77,211.73c-7.32,0-14.73-5.2-14.73-15.13V156.45a4.44,4.44,0,1,1,8.88,0V196.6c0,4.61,3.15,6.25,5.85,6.25a6,6,0,0,0,4.05-1.52,6.52,6.52,0,0,0,1.83-5V156.45a4.44,4.44,0,1,1,8.88,0v39.89a15.19,15.19,0,0,1-4.62,11.46A14.74,14.74,0,0,1,929.77,211.73Z"/><path class="cls-1" d="M1005.17,211.83l-10.84-.12a4.43,4.43,0,0,1-4.39-4.43v-50.9a4.43,4.43,0,0,1,4.43-4.43l10.79,0c9.46,0,15.11,5.44,15.11,14.55v30.64C1020.27,206.19,1014.48,211.83,1005.17,211.83Zm-6.36-8.94,6.4.07c4.44,0,6.19-1.64,6.19-5.85V166.47c0-3.51-1-5.68-6.23-5.68h-6.36Z"/><path class="cls-1" d="M773.56,211.65a4.9,4.9,0,0,1-4.92-5V156.94a4.93,4.93,0,0,1,9.68-1.22c0,.08,0,.2.08.34l0,.22a5.38,5.38,0,0,1,.07.78s0,44.16,0,44.72H789a4.93,4.93,0,1,1,0,9.86H773.56Z"/><path class="cls-1" d="M853.28,211.66a15,15,0,0,1-15-15V167.06a14.92,14.92,0,0,1,2.49-8.27l6.55,13.6v24.29a5.88,5.88,0,0,0,5.94,5.94,6,6,0,0,0,5.93-5.64l4.89,10a14.92,14.92,0,0,1-10.82,4.64m0-50.54a6,6,0,0,0-5.93,5.57l-4.84-10a15,15,0,0,1,25.75,10.41v29.62a14.93,14.93,0,0,1-2.45,8.2l-6.6-13.63V167.06a6,6,0,0,0-5.93-5.94"/></g></svg>

data/.github/workflows/publish.yml

@@ -46,9 +46,12 @@ jobs:
         id: old_version
         run: echo ::set-output name=VERSION::$(git tag --list "v*" --sort=version:refname | tail -n 2 | head -n 1)
 
+      - name: Get the release version
+        run: echo "RELEASE_VERSION=${GITHUB_REF:10}" >> $GITHUB_ENV
+
       - name: Check Version
         run: |
-          if [ "${{ steps.new_version.outputs.VERSION }}" != v$(cat lib/knife-ionoscloud/version.rb | grep 'VERSION =' | tr -s ' ' | cut -d ' ' -f 4 | sed 's/^.//;s/.$//') ]; then
+          if [ $RELEASE_VERSION != v$(cat lib/knife-ionoscloud/version.rb | grep 'VERSION =' | tr -s ' ' | cut -d ' ' -f 4 | sed 's/^.//;s/.$//') ]; then
             echo "Tag version does not match the one from version.rb!"
             exit 1
           fi

data/README.md

@@ -10,6 +10,15 @@
 [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=knife-plugin&metric=security_rating)](https://sonarcloud.io/dashboard?id=knife-plugin)
 [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=knife-plugin&metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=knife-plugin)
 
+![Alt text](.github/IONOS.CLOUD.BLU.svg?raw=true "Title")
+
+
+---
+**NOTE:**
+Be aware that the Chef IonosCloud Provider v6 will become main branch and it will be using the latest stable API Version.
+
+---
+
 ## Overview
 
 Chef is a popular configuration management tool that allows simplified configuration and maintenance of both servers and cloud provider environments through the use of common templates called recipes. The Chef `knife` command line tool allows management of various nodes within those environments. The `knife-ionoscloud` plugin utilizes the IONOS Cloud REST API to provision and manage various cloud resources on the IONOS Cloud platform.

data/docs/README.md

@@ -2,6 +2,12 @@
 
 ![CI](https://github.com/ionos-cloud/knife-ionos-cloud/workflows/CI/badge.svg) [![Gem Version](https://badge.fury.io/rb/knife-ionoscloud.svg)](https://badge.fury.io/rb/knife-ionoscloud) [![Gitter](https://badges.gitter.im/ionos-cloud/sdk-general.png)](https://gitter.im/ionos-cloud/sdk-general)
 
+---
+**NOTE:**
+Be aware that the Chef IonosCloud Provider v6 will become main branch and it will be using the latest stable API Version.
+
+---
+
 ## Overview
 
 Chef is a popular configuration management tool that allows simplified configuration and maintenance of both servers and cloud provider environments through the use of common templates called recipes. The Chef `knife` command line tool allows management of various nodes within those environments. The `knife-ionoscloud` plugin utilizes the IONOS Cloud REST API to provision and manage various cloud resources on the IONOS Cloud platform.
@@ -67,6 +73,37 @@ $ export IONOSCLOUD_PASSWORD='password'
 $ rspec spec
 ```
 
+### Getting input from a file
+
+In order to make passing JSON or array arguments easier, we allow you to specify a file which holds the arguments for a command. This is done with the
+`--extra-config EXTRA_CONFIG_FILE_PATH` or `-e EXTRA_CONFIG_FILE_PATH`. The file is expected to contain a JSON which should map the name of arguments to their expected values. Here is an example of such a file.
+
+```json
+{
+  "ionoscloud_username": "username",
+  "ionoscloud_password": "password",
+  "name": "test_datacenter_name",
+  "location": "de/txl"
+}
+```
+
+When using the command `knife ionoscloud datacenter create --extra-config EXTRA_CONFIG_FILE_PATH` where EXTRA_CONFIG_FILE_PATH is the name of the file containing the JSON above, the arguments described in the file will be used. 
+
+* If any of the arguments are set in any other way, the values from the file will be ignored. Running the command `knife ionoscloud datacenter create --location us/las --extra-config EXTRA_CONFIG_FILE_PATH` will create a datacenter in the 'us/las' location. In the same way if the values for ionoscloud_username and ionoscloud_password are already set in the knife.rb file, the contents from the JSON will be ignored.
+* Only Ionoscloud specific options may be altered using this option.
+* If an option is ignored because it is not on the available options list or if it is overwritten in another way then a warning message will be displayed.
+
+### Changing the API url
+
+By changing API url the module will make all calls using the provided url. To change the API url used by the knife module, one can do either of the following:
+* specify the new url using `--url NEW_URL`
+* set it in a json file, using the `ionoscloud_url` key, and passing the file to the command like described in the section above
+* set the new url in the knife.rb file. It could be set using an environmental variable, same as with the username and the password.
+
+```text
+knife[:ionoscloud_url] = NEW_API_URL
+```
+
 ## Feature Reference
 
 The IONOS Cloud plugin for Knife aims to offer access to all resources in the IONOS Cloud API and also offers some additional features that make the integration easier:

data/docs/changelog.md

@@ -1,2 +1,12 @@
 # Changelog
 
+## 6.0.0
+
+* First v6 stable release
+
+## 6.1.0
+
+### Enhancements:
+
+* added support for Dbaas Postgres
+* restructured documentation

data/docs/docs_generator.rb

@@ -3,11 +3,20 @@
 # This must be run from /docs directory
 
 require 'mustache'
+require 'fileutils'
 
 $LOAD_PATH << '.'
 
 Dir["../lib/chef/knife/*.rb"].each { |file| require file }
 
+FOLDER_TO_NAME_MAP = {
+  'backup' => 'Managed Backup',
+  'user' => 'User Management',
+  'compute-engine' => 'Compute Engine',
+  'kubernetes' => 'Managed Kubernetes',
+  'dbaas-postgres' => 'DbaaS Postgres',
+}.freeze
+
 def underscore_string(s)
   s.gsub(/::/, '/').
   gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2').
@@ -36,10 +45,10 @@ class Summary < Mustache
   self.template_path = './templates'
   self.template_file = './templates/summary.mustache'
 
-  attr_accessor :subcommands
+  attr_accessor :categories
 
-  def initialize(subcommands)
-    @subcommands = subcommands || []
+  def initialize(categories)
+    @categories = categories || []
   end
 end
 
@@ -49,12 +58,18 @@ def generate_subcommand_doc(subcommand)
     value[:required] = subcommand.required_options.include? key
     value[:description][0] = value[:description][0].downcase
     value
-  }.rotate(2)
+  }.rotate(3)
 
   subcommand_name = subcommand.class.to_s
   subcommand_name.slice!('Chef::Knife::Ionoscloud')
 
-  filename = "subcommands/#{underscore_string(subcommand_name)}.md"
+  begin
+    filename = "subcommands/#{subcommand.directory}/#{underscore_string(subcommand_name)}.md"
+    category = FOLDER_TO_NAME_MAP[subcommand.directory]
+  rescue NoMethodError
+    filename = "subcommands/#{underscore_string(subcommand_name)}.md"
+    category = ''
+  end
 
   begin
     description = subcommand.description
@@ -62,6 +77,8 @@ def generate_subcommand_doc(subcommand)
     description = ''
   end
 
+  FileUtils.mkdir_p(File.dirname(filename)) unless File.directory?(File.dirname(filename))
+
   File.open(filename, 'w') { |f|
     f.write(
       Subcommand.new(
@@ -75,7 +92,11 @@ def generate_subcommand_doc(subcommand)
   }
 
   puts "Generated documentation for #{subcommand_name}."
-  return subcommand_name, filename
+  {
+    title: subcommand_name,
+    filename: filename,
+    category: category,
+  }
 end
 
 subcommands = []
@@ -85,13 +106,14 @@ begin
     Chef::Knife.const_get(c).is_a?(Class) && c.to_s.start_with?('Ionoscloud')
   }.each {
     |subcommand|
+    # if subcommand.to_s == 'IonoscloudBackupunitCreate'
     begin
-      subcommand_name, filename = generate_subcommand_doc(Chef::Knife.const_get(subcommand).new)
-      subcommands.append({ title: subcommand_name, filename: filename })
+      subcommands.append(generate_subcommand_doc(Chef::Knife.const_get(subcommand).new))
     rescue Exception => exc
       puts "Could not generate doc for #{subcommand}. Error: #{exc}"
       # raise exc
     end
+    # end
   }
 rescue NameError => exc
   if exc.message == 'uninitialized constant Chef'
@@ -100,8 +122,21 @@ rescue NameError => exc
   raise exc
 end
 
-subcommands.sort! { |a, b| a[:title] <=> b[:title] }
+categories = {}
+
+subcommands.map do |subcommand|
+  if categories.key?(subcommand[:category])
+    categories[subcommand[:category]] << subcommand
+  else
+    categories[subcommand[:category]] = [subcommand]
+  end
+end
+
+
+final = []
+
+categories.map { |key, value| final << { category: key, subcommands: value } }
 
 File.open('summary.md', 'w') { |f|
-  f.write(Summary.new(subcommands).render,)
+  f.write(Summary.new(final).render)
 }

data/docs/subcommands/{backupunit_create.md → backup/backupunit_create.md}

@@ -17,6 +17,9 @@ knife ionoscloud backupunit create (options)
 * ionoscloud\_password
 
 ```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
     name: --name NAME, -n NAME
         alphanumeric name you want assigned to the backup unit (required)
 
@@ -32,9 +35,12 @@ knife ionoscloud backupunit create (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
 ```
 ## Example
 
 ```text
-knife ionoscloud backupunit create --name NAME --password PASSWORD --email EMAIL --username USERNAME --password PASSWORD
+knife ionoscloud backupunit create --extra-config EXTRA_CONFIG_FILE_PATH --name NAME --password PASSWORD --email EMAIL --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/{backupunit_delete.md → backup/backupunit_delete.md}

@@ -14,15 +14,21 @@ knife ionoscloud backupunit delete BACKUPUNIT_ID [BACKUPUNIT_ID]
 * ionoscloud\_password
 
 ```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
 
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
 ```
 ## Example
 
 ```text
-knife ionoscloud backupunit delete BACKUPUNIT_ID [BACKUPUNIT_ID]--username USERNAME --password PASSWORD
+knife ionoscloud backupunit delete BACKUPUNIT_ID [BACKUPUNIT_ID]--extra-config EXTRA_CONFIG_FILE_PATH --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/backup/backupunit_get.md

@@ -0,0 +1,38 @@
+# BackupunitGet
+
+Retrieves information about a backup unit.
+
+```text
+knife ionoscloud backupunit get (options)
+```
+
+## Available options:
+
+### Required options:
+
+* backupunit\_id
+* ionoscloud\_username
+* ionoscloud\_password
+
+```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
+    backupunit_id: --backupunit-id BACKUPUNIT_ID, -B BACKUPUNIT_ID
+        the ID of the Backup unit. (required)
+
+    ionoscloud_username: --username USERNAME, -u USERNAME
+        your Ionoscloud username (required)
+
+    ionoscloud_password: --password PASSWORD, -p PASSWORD
+        your Ionoscloud password (required)
+
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
+```
+## Example
+
+```text
+knife ionoscloud backupunit get --extra-config EXTRA_CONFIG_FILE_PATH --backupunit-id BACKUPUNIT_ID --username USERNAME --password PASSWORD --url URL
+```

data/docs/subcommands/{backupunit_list.md → backup/backupunit_list.md}

@@ -14,15 +14,21 @@ knife ionoscloud backupunit list
 * ionoscloud\_password
 
 ```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
 
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
 ```
 ## Example
 
 ```text
-knife ionoscloud backupunit list--username USERNAME --password PASSWORD
+knife ionoscloud backupunit list--extra-config EXTRA_CONFIG_FILE_PATH --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/{backupunit_ssourl.md → backup/backupunit_ssourl.md}

@@ -15,6 +15,9 @@ knife ionoscloud backupunit ssourl (options)
 * ionoscloud\_password
 
 ```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
     backupunit_id: --backupunit-id BACKUPUNIT_ID, -B BACKUPUNIT_ID
         the ID of the Backup unit. (required)
 
@@ -24,9 +27,12 @@ knife ionoscloud backupunit ssourl (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
 ```
 ## Example
 
 ```text
-knife ionoscloud backupunit ssourl --backupunit-id BACKUPUNIT_ID --username USERNAME --password PASSWORD
+knife ionoscloud backupunit ssourl --extra-config EXTRA_CONFIG_FILE_PATH --backupunit-id BACKUPUNIT_ID --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/backup/backupunit_update.md

@@ -0,0 +1,44 @@
+# BackupunitUpdate
+
+Retrieves information about a backup unit.
+
+```text
+knife ionoscloud backupunit update (options)
+```
+
+## Available options:
+
+### Required options:
+
+* backupunit\_id
+* ionoscloud\_username
+* ionoscloud\_password
+
+```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
+    backupunit_id: --backupunit-id BACKUPUNIT_ID, -B BACKUPUNIT_ID
+        the ID of the Backup unit. (required)
+
+    password: --password PASSWORD, -p PASSWORD
+        alphanumeric password you want assigned to the backup unit
+
+    email: --email EMAIL
+        the e-mail address you want assigned to the backup unit.
+
+    ionoscloud_username: --username USERNAME, -u USERNAME
+        your Ionoscloud username (required)
+
+    ionoscloud_password: --password PASSWORD, -p PASSWORD
+        your Ionoscloud password (required)
+
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
+```
+## Example
+
+```text
+knife ionoscloud backupunit update --extra-config EXTRA_CONFIG_FILE_PATH --backupunit-id BACKUPUNIT_ID --password PASSWORD --email EMAIL --username USERNAME --password PASSWORD --url URL
+```

data/docs/subcommands/{composite_server_create.md → compute-engine/composite_server_create.md}

@@ -22,6 +22,9 @@ knife ionoscloud composite server create (options)
 * ionoscloud\_password
 
 ```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
     datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
         name of the virtual datacenter (required)
 
@@ -70,6 +73,12 @@ knife ionoscloud composite server create (options)
     ssh_keys: --ssh-keys SSHKEY1,SSHKEY2,..., -K SSHKEY[,SSHKEY,...]
         a list of public SSH keys to include
 
+    backupunit_id: --backupunit BACKUPUNIT_ID, -B BACKUPUNIT_ID
+        the uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
+
+    user_data: --user-data USER_DATA, -u USER_DATA
+        the cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.
+
     nic_name: --nic-name NAME
         name of the NIC
 
@@ -82,8 +91,8 @@ knife ionoscloud composite server create (options)
     lan: --lan ID, -L ID
         the LAN ID the NIC will reside on; if the LAN ID does not exist it will be created (required)
 
-    nat: --nat
-        set to enable NAT on the NIC
+    firewall_type: --firewall-type FIREWALL_TYPE
+        the type of firewall rules that will be allowed on the NIC. If it is not specified it will take the default value INGRESS
 
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
@@ -91,9 +100,12 @@ knife ionoscloud composite server create (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
 ```
 ## Example
 
 ```text
-knife ionoscloud composite server create --datacenter-id DATACENTER_ID --name NAME --cores CORES --cpu-family CPU_FAMILY --ram RAM --availability-zone AVAILABILITY_ZONE --volume-name NAME --size SIZE --bus BUS --image ID --image-alias IMAGE_ALIAS --type TYPE --licence-type LICENCE --image-password PASSWORD --volume-availability-zone AVAILABILITY_ZONE --ssh-keys SSHKEY1,SSHKEY2,... --nic-name NAME --ips IP[,IP,...] --dhcp --lan ID --nat --username USERNAME --password PASSWORD
+knife ionoscloud composite server create --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --name NAME --cores CORES --cpu-family CPU_FAMILY --ram RAM --availability-zone AVAILABILITY_ZONE --volume-name NAME --size SIZE --bus BUS --image ID --image-alias IMAGE_ALIAS --type TYPE --licence-type LICENCE --image-password PASSWORD --volume-availability-zone AVAILABILITY_ZONE --ssh-keys SSHKEY1,SSHKEY2,... --backupunit BACKUPUNIT_ID --user-data USER_DATA --nic-name NAME --ips IP[,IP,...] --dhcp --lan ID --firewall-type FIREWALL_TYPE --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/compute-engine/cube_server_create.md

@@ -0,0 +1,94 @@
+# CubeServerCreate
+
+This creates a new cube server with an attached volume and NIC in a specified virtual data center.
+
+```text
+knife ionoscloud cube server create (options)
+```
+
+## Available options:
+
+### Required options:
+
+* datacenter\_id
+* name
+* template
+* ionoscloud\_username
+* ionoscloud\_password
+
+```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
+    datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
+        name of the virtual datacenter (required)
+
+    name: --name NAME, -n NAME
+        (required) Name of the server (required)
+
+    template: --template TEMPLATE_UUID
+        the UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource (required)
+
+    cpu_family: --cpu-family CPU_FAMILY, -f CPU_FAMILY
+        the family of processor cores (INTEL_XEON or AMD_OPTERON)
+
+    availability_zone: --availability-zone AVAILABILITY_ZONE, -a AVAILABILITY_ZONE
+        the availability zone of the server
+
+    volume_name: --volume-name NAME
+        name of the volume
+
+    bus: --bus BUS, -b BUS
+        the bus type of the volume (VIRTIO or IDE)
+
+    image: --image ID, -N ID
+        (required) The image or snapshot ID
+
+    licence_type: --licence-type LICENCE, -l LICENCE
+        the licence type of the volume (LINUX, WINDOWS, WINDOWS2016, UNKNOWN, OTHER)
+
+    image_password: --image-password PASSWORD, -P PASSWORD
+        the password set on the image for the "root" or "Administrator" user
+
+    ssh_keys: --ssh-keys SSHKEY1,SSHKEY2,..., -K SSHKEY[,SSHKEY,...]
+        a list of public SSH keys to include
+
+    backupunit_id: --backupunit BACKUPUNIT_ID, -B BACKUPUNIT_ID
+        the uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
+
+    user_data: --user-data USER_DATA, -u USER_DATA
+        the cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.
+
+    set_boot: --set-boot
+        whether to set the volume as the boot volume
+
+    nic_name: --nic-name NAME
+        name of the NIC
+
+    ips: --ips IP[,IP,...], -i IP[,IP,...]
+        iPs assigned to the NIC
+
+    dhcp: --dhcp, -h
+        set to false if you wish to disable DHCP
+
+    lan: --lan ID, -L ID
+        the LAN ID the NIC will reside on; if the LAN ID does not exist it will be created
+
+    firewall_type: --firewall-type FIREWALL_TYPE, -t FIREWALL_TYPE
+        the type of firewall rules that will be allowed on the NIC. If it is not specified it will take the default value INGRESS
+
+    ionoscloud_username: --username USERNAME, -u USERNAME
+        your Ionoscloud username (required)
+
+    ionoscloud_password: --password PASSWORD, -p PASSWORD
+        your Ionoscloud password (required)
+
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
+```
+## Example
+
+```text
+knife ionoscloud cube server create --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --name NAME --template TEMPLATE_UUID --cpu-family CPU_FAMILY --availability-zone AVAILABILITY_ZONE --volume-name NAME --bus BUS --image ID --licence-type LICENCE --image-password PASSWORD --ssh-keys SSHKEY1,SSHKEY2,... --backupunit BACKUPUNIT_ID --user-data USER_DATA --set-boot --nic-name NAME --ips IP[,IP,...] --dhcp --lan ID --firewall-type FIREWALL_TYPE --username USERNAME --password PASSWORD --url URL
+```

data/docs/subcommands/{datacenter_create.md → compute-engine/datacenter_create.md}

@@ -22,6 +22,9 @@ knife ionoscloud datacenter create (options)
 * ionoscloud\_password
 
 ```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
     name: --name NAME, -n NAME
         name of the data center
 
@@ -37,9 +40,12 @@ knife ionoscloud datacenter create (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
 ```
 ## Example
 
 ```text
-knife ionoscloud datacenter create --name NAME --description DESCRIPTION --location LOCATION --username USERNAME --password PASSWORD
+knife ionoscloud datacenter create --extra-config EXTRA_CONFIG_FILE_PATH --name NAME --description DESCRIPTION --location LOCATION --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/{datacenter_delete.md → compute-engine/datacenter_delete.md}

@@ -14,15 +14,21 @@ knife ionoscloud datacenter delete DATACENTER_ID [DATACENTER_ID]
 * ionoscloud\_password
 
 ```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
 
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
 ```
 ## Example
 
 ```text
-knife ionoscloud datacenter delete DATACENTER_ID [DATACENTER_ID]--username USERNAME --password PASSWORD
+knife ionoscloud datacenter delete DATACENTER_ID [DATACENTER_ID]--extra-config EXTRA_CONFIG_FILE_PATH --username USERNAME --password PASSWORD --url URL
 ```

data/docs/subcommands/compute-engine/datacenter_get.md

@@ -0,0 +1,38 @@
+# DatacenterGet
+
+Retrieves information about a Ionoscloud Datacenter.
+
+```text
+knife ionoscloud datacenter get (options)
+```
+
+## Available options:
+
+### Required options:
+
+* datacenter\_id
+* ionoscloud\_username
+* ionoscloud\_password
+
+```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
+    datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
+        iD of the data center (required)
+
+    ionoscloud_username: --username USERNAME, -u USERNAME
+        your Ionoscloud username (required)
+
+    ionoscloud_password: --password PASSWORD, -p PASSWORD
+        your Ionoscloud password (required)
+
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
+```
+## Example
+
+```text
+knife ionoscloud datacenter get --extra-config EXTRA_CONFIG_FILE_PATH --datacenter-id DATACENTER_ID --username USERNAME --password PASSWORD --url URL
+```

data/docs/subcommands/{datacenter_list.md → compute-engine/datacenter_list.md}

@@ -14,15 +14,21 @@ knife ionoscloud datacenter list
 * ionoscloud\_password
 
 ```text
+    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
+        path to the additional config file
+
     ionoscloud_username: --username USERNAME, -u USERNAME
         your Ionoscloud username (required)
 
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
+
 ```
 ## Example
 
 ```text
-knife ionoscloud datacenter list--username USERNAME --password PASSWORD
+knife ionoscloud datacenter list--extra-config EXTRA_CONFIG_FILE_PATH --username USERNAME --password PASSWORD --url URL
 ```