knife-ionoscloud 6.0.0.beta.2 → 6.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7eb585be2cb294b884a7a37fa48edfc54998716ffcbce169898372eb9e24f143
-  data.tar.gz: 95ea0e6e4ab11d865c63537b6dd63bef204197e1a32610a3c7208018c8c7f8a1
+  metadata.gz: 9385d226271569cd7a89fa7d99feb5c96f3d693b5e44d521d706b9d89c40777d
+  data.tar.gz: 6150c9bbc71616e583055427fa7cc973cb65e4dad19fdabe86af50de9a1b02fa
 SHA512:
-  metadata.gz: dd0ee5ff7332cfb3004000b7d8f422bf370d4e0d06c0c4185144fb83d790b123d3479f3cf1886cbd2f5eb4a9c78d3baed152f6941db3687c47e3825400bdbed0
-  data.tar.gz: d1b0da891bea8cf664277a8d298cefbc1d42c08b698d9c7810011346b92f437526104049c0926535c083c0883836af6c18989bf2472b30f36ceb3e4a5d9aafc8
+  metadata.gz: 42a7960791b3f0a8bc15bb544afc1f37ceb90f66f99d334ed8668c49109ebfada511829b73a044e47363f6869e86c42e9dd18d91f2fbecbe535eaa6b0f3df904
+  data.tar.gz: 904dc4e6a4efb8b02f8f951dbda26c1209b73b3597837197f431631ed6727ed23bc6e5dc59021b0f4d88e4d5192d28c1c6acdc4a2068946280aa714fe50d5a30

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/build.yml

@@ -1,3 +1,5 @@
+
+  
 name: Build
 on:
   push:
@@ -13,6 +15,21 @@ jobs:
       - uses: actions/checkout@v2
         with:
           fetch-depth: 0  # Shallow clones should be disabled for a better relevancy of analysis
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1.61.1
+        with:
+          ruby-version: 2.7
+
+      - name: Install the knife plugin
+        run: bundle
+
+      - name: Run the tests
+        run: rspec
+      
+      - name: Update file paths in coverage.json
+        run: sed -i 's+/home/runner/work/knife-ionos-cloud/knife-ionos-cloud+/github/workspace+g' coverage/coverage.json
+
       - name: SonarCloud Scan
         uses: SonarSource/sonarcloud-github-action@master
         env:

data/.rubocop.yml

@@ -145,3 +145,75 @@ Style/RedundantReturn:
 Style/Semicolon:
   Enabled: true
   AllowAsExpressionSeparator: true
+
+Lint/RescueException:
+  Enabled: true
+
+Style/BlockDelimiters:
+  Enabled: true
+
+Layout/DotPosition:
+  Enabled: true
+
+Style/StringLiterals:
+  Enabled: true
+
+Style/IfUnlessModifier:
+  Enabled: true
+
+Layout/MultilineBlockLayout:
+  Enabled: true
+
+Layout/EmptyLinesAroundBlockBody:
+  Enabled: true
+
+Style/TrailingCommaInHashLiteral:
+  Description: 'Checks for trailing comma in hash literals.'
+  Enabled: true
+  # If `comma`, the cop requires a comma after the last item in a hash,
+  # but only when each item is on its own line.
+  # If `consistent_comma`, the cop requires a comma after the last item of all
+  # non-empty, multiline hash literals.
+  EnforcedStyleForMultiline: consistent_comma
+  SupportedStylesForMultiline:
+    - comma
+    - consistent_comma
+    - no_comma
+  VersionAdded: '0.53'
+
+Style/TrailingCommaInArguments:
+  Description: 'Checks for trailing comma in argument lists.'
+  StyleGuide: '#no-trailing-params-comma'
+  Enabled: true
+  VersionAdded: '0.36'
+  # If `comma`, the cop requires a comma after the last argument, but only for
+  # parenthesized method calls where each argument is on its own line.
+  # If `consistent_comma`, the cop requires a comma after the last argument,
+  # for all parenthesized method calls with arguments.
+  EnforcedStyleForMultiline: consistent_comma
+  SupportedStylesForMultiline:
+    - comma
+    - consistent_comma
+    - no_comma
+
+Style/TrailingCommaInArrayLiteral:
+  Description: 'Checks for trailing comma in array literals.'
+  StyleGuide: '#no-trailing-array-commas'
+  Enabled: true
+  VersionAdded: '0.53'
+  # If `comma`, the cop requires a comma after the last item in an array,
+  # but only when each item is on its own line.
+  # If `consistent_comma`, the cop requires a comma after the last item of all
+  # non-empty, multiline array literals.
+  EnforcedStyleForMultiline: consistent_comma
+  SupportedStylesForMultiline:
+    - comma
+    - consistent_comma
+    - no_comma
+
+Lint/UselessAssignment:
+  Enabled: true
+
+Layout/LineLength:
+  Enabled: false
+  Max: 120

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.
@@ -87,6 +93,17 @@ When using the command `knife ionoscloud datacenter create --extra-config EXTRA_
 * 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,17 +3,26 @@
 # This must be run from /docs directory
 
 require 'mustache'
+require 'fileutils'
 
 $LOAD_PATH << '.'
 
-Dir["../lib/chef/knife/*.rb"].each { |file| require file }
+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').
-  gsub(/([a-z\d])([A-Z])/, '\1_\2').
-  tr("-", "_").
-  downcase
+  s.gsub(/::/, '/')
+  .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+  .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+  .tr('-', '_')
+  .downcase
 end
 
 class Subcommand < Mustache
@@ -36,25 +45,31 @@ 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
 
 def generate_subcommand_doc(subcommand)
-  options = subcommand.options.map { |key, value|
+  options = subcommand.options.map do |key, value|
     value[:name] = key
     value[:required] = subcommand.required_options.include? key
     value[:description][0] = value[:description][0].downcase
     value
-  }.rotate(3)
+  end.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,7 +77,9 @@ def generate_subcommand_doc(subcommand)
     description = ''
   end
 
-  File.open(filename, 'w') { |f|
+  FileUtils.mkdir_p(File.dirname(filename)) unless File.directory?(File.dirname(filename))
+
+  File.open(filename, 'w') do |f|
     f.write(
       Subcommand.new(
         subcommand.banner,
@@ -72,36 +89,51 @@ def generate_subcommand_doc(subcommand)
         subcommand.required_options.map { |el| el.to_s.gsub '_', '\_' },
       ).render,
     )
-  }
+  end
 
   puts "Generated documentation for #{subcommand_name}."
-  return subcommand_name, filename
+  {
+    title: subcommand_name,
+    filename: filename,
+    category: category,
+  }
 end
 
 subcommands = []
 
 begin
-  Chef::Knife.constants.select { |c|
+  Chef::Knife.constants.select do |c|
     Chef::Knife.const_get(c).is_a?(Class) && c.to_s.start_with?('Ionoscloud')
-  }.each {
-    |subcommand|
+  end.each do |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 })
-    rescue Exception => exc
+      subcommands.append(generate_subcommand_doc(Chef::Knife.const_get(subcommand).new))
+    rescue StandardError => exc
       puts "Could not generate doc for #{subcommand}. Error: #{exc}"
       # raise exc
     end
-  }
-rescue NameError => exc
-  if exc.message == 'uninitialized constant Chef'
-    puts 'This must be run from /docs directory!'
+    # end
   end
+rescue NameError => exc
+  puts 'This must be run from /docs directory!' if exc.message == 'uninitialized constant Chef'
   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
 
-File.open('summary.md', 'w') { |f|
-  f.write(Summary.new(subcommands).render,)
-}
+
+final_categories = []
+
+categories.map { |key, value| final_categories << { category: key, subcommands: value.sort_by { |a| a[:title] } } }
+
+File.open('summary.md', 'w') do |f|
+  f.write(Summary.new(final_categories).render)
+end

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,12 +35,12 @@ knife ionoscloud backupunit create (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
-    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
-        path to the additional config file
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
 
 ```
 ## Example
 
 ```text
-knife ionoscloud backupunit create --name NAME --password PASSWORD --email EMAIL --username USERNAME --password PASSWORD --extra-config EXTRA_CONFIG_FILE_PATH
+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,18 +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)
 
-    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
-        path to the additional config file
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
 
 ```
 ## Example
 
 ```text
-knife ionoscloud backupunit delete BACKUPUNIT_ID [BACKUPUNIT_ID]--username USERNAME --password PASSWORD --extra-config EXTRA_CONFIG_FILE_PATH
+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,18 +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)
 
-    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
-        path to the additional config file
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
 
 ```
 ## Example
 
 ```text
-knife ionoscloud backupunit list--username USERNAME --password PASSWORD --extra-config EXTRA_CONFIG_FILE_PATH
+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,12 +27,12 @@ knife ionoscloud backupunit ssourl (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
-    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
-        path to the additional config file
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
 
 ```
 ## Example
 
 ```text
-knife ionoscloud backupunit ssourl --backupunit-id BACKUPUNIT_ID --username USERNAME --password PASSWORD --extra-config EXTRA_CONFIG_FILE_PATH
+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)
 
@@ -97,12 +100,12 @@ knife ionoscloud composite server create (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
-    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
-        path to the additional config file
+    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,... --backupunit BACKUPUNIT_ID --user-data USER_DATA --nic-name NAME --ips IP[,IP,...] --dhcp --lan ID --firewall-type FIREWALL_TYPE --username USERNAME --password PASSWORD --extra-config EXTRA_CONFIG_FILE_PATH
+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/{cube_server_create.md → compute-engine/cube_server_create.md}

@@ -17,6 +17,9 @@ knife ionoscloud cube 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)
 
@@ -80,12 +83,12 @@ knife ionoscloud cube server create (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
-    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
-        path to the additional config file
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
 
 ```
 ## Example
 
 ```text
-knife ionoscloud cube server create --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 --extra-config EXTRA_CONFIG_FILE_PATH
+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,12 +40,12 @@ knife ionoscloud datacenter create (options)
     ionoscloud_password: --password PASSWORD, -p PASSWORD
         your Ionoscloud password (required)
 
-    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
-        path to the additional config file
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
 
 ```
 ## Example
 
 ```text
-knife ionoscloud datacenter create --name NAME --description DESCRIPTION --location LOCATION --username USERNAME --password PASSWORD --extra-config EXTRA_CONFIG_FILE_PATH
+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,18 +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)
 
-    extra_config_file: --extra-config EXTRA_CONFIG_FILE_PATH, -e EXTRA_CONFIG_FILE_PATH
-        path to the additional config file
+    ionoscloud_url: --url URL
+        the Ionoscloud API URL
 
 ```
 ## Example
 
 ```text
-knife ionoscloud datacenter delete DATACENTER_ID [DATACENTER_ID]--username USERNAME --password PASSWORD --extra-config EXTRA_CONFIG_FILE_PATH
+knife ionoscloud datacenter delete DATACENTER_ID [DATACENTER_ID]--extra-config EXTRA_CONFIG_FILE_PATH --username USERNAME --password PASSWORD --url URL
 ```