✨ feat(kube): add OKS aliases

[jfbus]

Description

This PR adds OKS aliases:

• octl kube project create/list/describe/update/delete/clusters/nets/snapshots/public-ips/quotas for project management
• octl kube cluster create/list/describe/update/delete/ kubeconfig for cluster management
• octl kube nodepool create/list/describe/delete for nodepool management
• octl kube kubectl for kubectl access

Type of Change

Please check the relevant option(s):

• 🐛 Bug fix
• ✨ New feature
• 🧹 Code cleanup or refactor
• 📝 Documentation update
• 🔧 Build or CI-related change
• 🔒 Security fix
• Other (specify):

How Has This Been Tested?

Please describe the test strategy:

• Manual testing
• Unit tests
• Integration tests
• Not tested yet

Checklist

• I have followed the Contributing Guidelines
• I have added tests or explained why they are not needed
• I have updated relevant documentation (README, examples, etc.)
• My changes follow the Conventional Commits specification
• My commits include appropriate Gitmoji

Additional Context

[github-actions]

WARNING : Differences in reference doc 🤔

 docs/reference/octl_iaas_catalog.md                |   1 -
 docs/reference/octl_iaas_catalog_list.md           |  11 +--
 docs/reference/octl_iaas_usergroup.md              |   1 -
 docs/reference/octl_iaas_usergrouppolicy.md        |   1 -
 docs/reference/octl_iaas_usergrouppolicy_list.md   |   8 +-
 docs/reference/octl_iaas_userpolicy.md             |   1 -
 docs/reference/octl_iaas_userpolicy_list.md        |  11 +--
 docs/reference/octl_kube.md                        |   7 ++
 docs/reference/octl_kube_api.md                    |  38 ++++----
 docs/reference/octl_kube_api_CreateCluster.md      |  64 ++++++------
 docs/reference/octl_kube_api_CreateProject.md      |  14 ++-
 docs/reference/octl_kube_api_DeleteCluster.md      |   4 +
 docs/reference/octl_kube_api_DeleteProject.md      |   4 +
 docs/reference/octl_kube_api_GetCPSubregions.md    |   4 +
 docs/reference/octl_kube_api_GetCluster.md         |   4 +
 docs/reference/octl_kube_api_GetClusterTemplate.md |   4 +
 .../octl_kube_api_GetControlPlanePlans.md          |   4 +
 .../octl_kube_api_GetKubeconfigWithPubkeyNACL.md   |   4 +
 .../octl_kube_api_GetKubernetesVersions.md         |   4 +
 ...ctl_kube_api_GetNetPeeringAcceptanceTemplate.md |   4 +
 .../octl_kube_api_GetNetPeeringRequestTemplate.md  |   4 +
 .../reference/octl_kube_api_GetNodepoolTemplate.md |   4 +
 docs/reference/octl_kube_api_GetProject.md         |   4 +
 docs/reference/octl_kube_api_GetProjectTemplate.md |   4 +
 docs/reference/octl_kube_api_ListProjects.md       |   4 +
 docs/reference/octl_kube_api_UpdateCluster.md      |  42 ++++----
 docs/reference/octl_kube_api_UpdateProject.md      |   4 +
 docs/reference/octl_kube_api_UpgradeCluster.md     |   4 +
 docs/reference/octl_kube_cluster.md                |  41 ++++++++
 docs/reference/octl_kube_cluster_create.md         |  79 +++++++++++++++
 docs/reference/octl_kube_cluster_delete.md         |  45 +++++++++
 docs/reference/octl_kube_cluster_describe.md       |  45 +++++++++
 docs/reference/octl_kube_cluster_kubeconfig.md     |  45 +++++++++
 docs/reference/octl_kube_cluster_list.md           |  52 ++++++++++
 docs/reference/octl_kube_cluster_update.md         |  45 +++++++++
 docs/reference/octl_kube_kubeconfig.md             |  36 +++++++
 docs/reference/octl_kube_kubeconfig_describe.md    |  45 +++++++++
 docs/reference/octl_kube_kubectl.md                |  44 +++++++++
 docs/reference/octl_kube_nodepool.md               |  40 ++++++++
 docs/reference/octl_kube_nodepool_api.md           |  41 ++++++++
 docs/reference/octl_kube_nodepool_api_Create.md    | 108 +++++++++++++++++++++
 docs/reference/octl_kube_nodepool_api_Delete.md    |  40 ++++++++
 docs/reference/octl_kube_nodepool_api_Get.md       |  40 ++++++++
 docs/reference/octl_kube_nodepool_api_List.md      |  40 ++++++++
 docs/reference/octl_kube_nodepool_api_Update.md    | 108 +++++++++++++++++++++
 docs/reference/octl_kube_nodepool_create.md        |  75 ++++++++++++++
 docs/reference/octl_kube_nodepool_delete.md        |  46 +++++++++
 docs/reference/octl_kube_nodepool_describe.md      |  46 +++++++++
 docs/reference/octl_kube_nodepool_list.md          |  46 +++++++++
 docs/reference/octl_kube_project.md                |  45 +++++++++
 docs/reference/octl_kube_project_clusters.md       |  52 ++++++++++
 docs/reference/octl_kube_project_create.md         |  51 ++++++++++
 docs/reference/octl_kube_project_delete.md         |  45 +++++++++
 docs/reference/octl_kube_project_describe.md       |  45 +++++++++
 docs/reference/octl_kube_project_list.md           |  52 ++++++++++
 docs/reference/octl_kube_project_nets.md           |  45 +++++++++
 docs/reference/octl_kube_project_public-ips.md     |  45 +++++++++
 docs/reference/octl_kube_project_quotas.md         |  45 +++++++++
 docs/reference/octl_kube_project_snapshots.md      |  45 +++++++++
 docs/reference/octl_kube_project_update.md         |  45 +++++++++
 docs/reference/octl_kube_publicip.md               |  36 +++++++
 docs/reference/octl_kube_publicip_describe.md      |  45 +++++++++
 docs/reference/octl_kube_quota.md                  |  36 +++++++
 docs/reference/octl_kube_quota_describe.md         |  45 +++++++++
 64 files changed, 1953 insertions(+), 94 deletions(-)

Detailed changes

docs/reference/octl_iaas_catalog.md

-* [octl iaas catalog list](octl_iaas_catalog_list.md)	 - alias for api ReadCatalogs

docs/reference/octl_iaas_catalog_list.md

-alias for api ReadCatalogs
+alias for api ReadCatalog
-> *alias for api ReadCatalogs*
+> *alias for api ReadCatalog*
-Returns the price list of OUTSCALE services for the current Region within a specific time period.
+Returns the price list of OUTSCALE services for the current Region.
-      --current-catalog-only   By default or if set to true, only returns the current catalog.
-      --from-date osctime      The beginning of the time period, in ISO 8601 date format (for example, 2020-06-14).
-      --to-date osctime        The end of the time period, in ISO 8601 date format (for example, 2020-06-30).

docs/reference/octl_iaas_usergroup.md

-* [octl iaas usergroup list](octl_iaas_usergroup_list.md)	 - alias for api ReadUserGroup

docs/reference/octl_iaas_usergrouppolicy.md

-* [octl iaas usergrouppolicy list](octl_iaas_usergrouppolicy_list.md)	 - alias for api ReadUserGroupPolicy

docs/reference/octl_iaas_usergrouppolicy_list.md

-alias for api ReadUserGroupPolicy
+alias for api ReadUserGroupPolicies
-> *alias for api ReadUserGroupPolicy*
+> *alias for api ReadUserGroupPolicies*
-Returns information about an inline policy included in a specified group.
+Lists the names of the inline policies embedded in a specific group.
+      --first-item int           The item starting the list of policies requested.
-      --name string              The name of the policy.

docs/reference/octl_iaas_userpolicy.md

-* [octl iaas userpolicy list](octl_iaas_userpolicy_list.md)	 - alias for api ReadUserPolicy

docs/reference/octl_iaas_userpolicy_list.md

-alias for api ReadUserPolicy
+alias for api ReadUserPolicies
-> *alias for api ReadUserPolicy*
+> *alias for api ReadUserPolicies*
-Returns information about an inline policy included in a specified user.
+Lists the names of inline policies included in a specified user.
-      --policy-name string   The name of the policy.

docs/reference/octl_kube.md

+* [octl kube cluster](octl_kube_cluster.md)	 - cluster commands
+* [octl kube kubeconfig](octl_kube_kubeconfig.md)	 - kubeconfig commands
+* [octl kube kubectl](octl_kube_kubectl.md)	 - 
+* [octl kube nodepool](octl_kube_nodepool.md)	 - nodepool commands
+* [octl kube project](octl_kube_project.md)	 - project commands
+* [octl kube publicip](octl_kube_publicip.md)	 - publicip commands
+* [octl kube quota](octl_kube_quota.md)	 - quota commands

docs/reference/octl_kube_api.md

-* [octl kube api CreateCluster](octl_kube_api_CreateCluster.md)	 - 
-* [octl kube api CreateProject](octl_kube_api_CreateProject.md)	 - 
-* [octl kube api DeleteCluster](octl_kube_api_DeleteCluster.md)	 - 
-* [octl kube api DeleteProject](octl_kube_api_DeleteProject.md)	 - 
-* [octl kube api GetCPSubregions](octl_kube_api_GetCPSubregions.md)	 - 
-* [octl kube api GetCluster](octl_kube_api_GetCluster.md)	 - 
-* [octl kube api GetClusterTemplate](octl_kube_api_GetClusterTemplate.md)	 - 
-* [octl kube api GetControlPlanePlans](octl_kube_api_GetControlPlanePlans.md)	 - 
+* [octl kube api CreateCluster](octl_kube_api_CreateCluster.md)	 - Creates a new cluster with the provided configuration.
+* [octl kube api CreateProject](octl_kube_api_CreateProject.md)	 - Creates a new project with the provided details.
+* [octl kube api DeleteCluster](octl_kube_api_DeleteCluster.md)	 - request returning *DetailResponse
+* [octl kube api DeleteProject](octl_kube_api_DeleteProject.md)	 - request returning *DetailResponse
+* [octl kube api GetCPSubregions](octl_kube_api_GetCPSubregions.md)	 - request returning *CPSubregionsResponse
+* [octl kube api GetCluster](octl_kube_api_GetCluster.md)	 - request returning *ClusterResponse
+* [octl kube api GetClusterTemplate](octl_kube_api_GetClusterTemplate.md)	 - request returning *TemplateResponseClusterInputTemplate
+* [octl kube api GetControlPlanePlans](octl_kube_api_GetControlPlanePlans.md)	 - request returning *ControlPlanesResponse
-* [octl kube api GetKubeconfigWithPubkeyNACL](octl_kube_api_GetKubeconfigWithPubkeyNACL.md)	 - 
-* [octl kube api GetKubernetesVersions](octl_kube_api_GetKubernetesVersions.md)	 - 
-* [octl kube api GetNetPeeringAcceptanceTemplate](octl_kube_api_GetNetPeeringAcceptanceTemplate.md)	 - 
-* [octl kube api GetNetPeeringRequestTemplate](octl_kube_api_GetNetPeeringRequestTemplate.md)	 - 
-* [octl kube api GetNodepoolTemplate](octl_kube_api_GetNodepoolTemplate.md)	 - 
-* [octl kube api GetProject](octl_kube_api_GetProject.md)	 - 
+* [octl kube api GetKubeconfigWithPubkeyNACL](octl_kube_api_GetKubeconfigWithPubkeyNACL.md)	 - request returning *KubeconfigResponse
+* [octl kube api GetKubernetesVersions](octl_kube_api_GetKubernetesVersions.md)	 - request returning *KubernetesVersionsResponse
+* [octl kube api GetNetPeeringAcceptanceTemplate](octl_kube_api_GetNetPeeringAcceptanceTemplate.md)	 - request returning *TemplateResponseNetPeeringAcceptance
+* [octl kube api GetNetPeeringRequestTemplate](octl_kube_api_GetNetPeeringRequestTemplate.md)	 - request returning *TemplateResponseNetPeeringRequest
+* [octl kube api GetNodepoolTemplate](octl_kube_api_GetNodepoolTemplate.md)	 - request returning *TemplateResponseNodepool
+* [octl kube api GetProject](octl_kube_api_GetProject.md)	 - request returning *ProjectResponse
-* [octl kube api GetProjectTemplate](octl_kube_api_GetProjectTemplate.md)	 - 
+* [octl kube api GetProjectTemplate](octl_kube_api_GetProjectTemplate.md)	 - request returning *TemplateResponseProjectInput
-* [octl kube api ListProjects](octl_kube_api_ListProjects.md)	 - 
-* [octl kube api UpdateCluster](octl_kube_api_UpdateCluster.md)	 - 
-* [octl kube api UpdateProject](octl_kube_api_UpdateProject.md)	 - 
-* [octl kube api UpgradeCluster](octl_kube_api_UpgradeCluster.md)	 - 
+* [octl kube api ListProjects](octl_kube_api_ListProjects.md)	 - request returning *ProjectResponseList
+* [octl kube api UpdateCluster](octl_kube_api_UpdateCluster.md)	 - Updates the configuration of an existing cluster by its ID.
+* [octl kube api UpdateProject](octl_kube_api_UpdateProject.md)	 - Updates the details of an existing project by its ID.
+* [octl kube api UpgradeCluster](octl_kube_api_UpgradeCluster.md)	 - request returning *ClusterResponse

docs/reference/octl_kube_api_CreateCluster.md

+Creates a new cluster with the provided configuration.
+### Synopsis
+
+Creates a new cluster with the provided configuration. The request must include the cluster details in the request body. all clusters are associated to a project
-      --AdminLbu                                                     
-      --AdminWhitelist strings                                       
-      --AdmissionFlags.DisableAdmissionPlugins strings               
-      --AdmissionFlags.EnableAdmissionPlugins strings                
-      --Auth.Oidc.ClientId string                                    
+      --AdminLbu                                                     Flag to enable admin load balancer for cluster management
+      --AdminWhitelist strings                                       List of CIDR blocks or IP addresses allowed to access the Kubernetes API
+      --AdmissionFlags.DisableAdmissionPlugins strings               List of Kubernetes admission plugins to disable
+      --AdmissionFlags.EnableAdmissionPlugins strings                List of Kubernetes admission plugins to enable
+      --Auth.Oidc.ClientId string                                    The client id that all tokens must be issued for.
-      --Auth.Oidc.IssuerUrl string                                   
+      --Auth.Oidc.IssuerUrl string                                   The URL of the provider that allows the API server to discover public signing keys.
-      --AutoMaintenances.MinorUpgradeMaintenance.DurationHours int   
-      --AutoMaintenances.MinorUpgradeMaintenance.Enabled             
-      --AutoMaintenances.MinorUpgradeMaintenance.StartHour int       
-      --AutoMaintenances.MinorUpgradeMaintenance.Tz string           
-      --AutoMaintenances.MinorUpgradeMaintenance.WeekDay string      
-      --AutoMaintenances.PatchUpgradeMaintenance.DurationHours int   
-      --AutoMaintenances.PatchUpgradeMaintenance.Enabled             
-      --AutoMaintenances.PatchUpgradeMaintenance.StartHour int       
-      --AutoMaintenances.PatchUpgradeMaintenance.Tz string           
-      --AutoMaintenances.PatchUpgradeMaintenance.WeekDay string      
-      --CidrPods string                                              
-      --CidrService string                                           
-      --ClusterDns string                                            
-      --ControlPlanes string                                         
-      --CpMultiAz                                                    
-      --CpSubregions strings                                         
+      --AutoMaintenances.MinorUpgradeMaintenance.DurationHours int   Duration of the maintenance window in hours
+      --AutoMaintenances.MinorUpgradeMaintenance.Enabled             Flag to enable or disable the maintenance window
+      --AutoMaintenances.MinorUpgradeMaintenance.StartHour int       Hour of the day when maintenance window starts (0-23)
+      --AutoMaintenances.MinorUpgradeMaintenance.Tz string           Timezone for the maintenance window
+      --AutoMaintenances.MinorUpgradeMaintenance.WeekDay string      Day of the week for the maintenance window
+      --AutoMaintenances.PatchUpgradeMaintenance.DurationHours int   Duration of the maintenance window in hours
+      --AutoMaintenances.PatchUpgradeMaintenance.Enabled             Flag to enable or disable the maintenance window
+      --AutoMaintenances.PatchUpgradeMaintenance.StartHour int       Hour of the day when maintenance window starts (0-23)
+      --AutoMaintenances.PatchUpgradeMaintenance.Tz string           Timezone for the maintenance window
+      --AutoMaintenances.PatchUpgradeMaintenance.WeekDay string      Day of the week for the maintenance window
+      --CidrPods string                                              CIDR block for Kubernetes pods network
+      --CidrService string                                           CIDR block for Kubernetes services network
+      --ClusterDns string                                            IP address for cluster DNS service
+      --ControlPlanes string                                         Size of control plane deployment for the cluster
+      --CpMultiAz                                                    Flag to enable multi-availability zone for the control plane
+      --CpSubregions strings                                         List of subregions where control plane components are deployed
-      --DisableApiTermination                                        
-      --MaintenanceWindow.DurationHours int                          
-      --MaintenanceWindow.StartHour int                              
-      --MaintenanceWindow.Tz string                                  
-      --MaintenanceWindow.WeekDay string                             
-      --Name string                                                  
-      --ProjectId string                                             
+      --DisableApiTermination                                        Flag to prevent accidental cluster deletion
+      --MaintenanceWindow.DurationHours int                          Duration of the maintenance window in hours
+      --MaintenanceWindow.StartHour int                              Hour of the day when maintenance window starts (0-23)
+      --MaintenanceWindow.Tz string                                  Timezone for the maintenance window
+      --MaintenanceWindow.WeekDay string                             Day of the week for the maintenance window
+      --Name string                                                  Unique cluster name per project, must start with a letter and contain only lowercase letters, numbers, or hyphens
+      --ProjectId string                                             Unique identifier of the project this cluster belongs to
-      --Version string                                               
+      --Version string                                               Version of Kubernetes to be deployed

docs/reference/octl_kube_api_CreateProject.md

+Creates a new project with the provided details.
+### Synopsis
+
+Creates a new project with the provided details. The request must include the project data in the request body. Returns the details of the created project.
-      --Cidr string             
-      --Description string      
-      --DisableApiTermination   
-      --Name string             
+      --Cidr string             CIDR block associated with the project's VPC
+      --Description string      Optional description of the project
+      --DisableApiTermination   Flag to prevent accidental project deletion
+      --Name string             Unique name for the project, must start with a letter and contain only lowercase letters, numbers, or hyphens
-      --Region string           
+      --Region string           Region where the project is deployed

docs/reference/octl_kube_api_DeleteCluster.md

+request returning *DetailResponse
+### Synopsis
+
+request returning *DetailResponse

docs/reference/octl_kube_api_DeleteProject.md

+request returning *DetailResponse
+### Synopsis
+
+request returning *DetailResponse

docs/reference/octl_kube_api_GetCPSubregions.md

[...]

[github-actions]

Binary size: 38.4MB => 81.5MB (change +44176KB, +112.2%) 😭