Improved descriptions, updated dependencies

Co-authored-by: Erasmo <[email protected]>

Updated with suggestions

Co-authored-by: Erasmo <[email protected]>

docs/index.md

@@ -3,12 +3,16 @@
 page_title: "liqo Provider"
 subcategory: ""
 description: |-
-  Interact with Liqo.
+  Liqo provider to enable seamless and secure resource sharing between multiple
+  Kubernetes clusters, creating a single virtual cluster that spans across
+  multiple physical ones.
 ---
 
 # liqo Provider
 
-Interact with Liqo.
+Liqo provider to enable seamless and secure resource sharing between multiple
+Kubernetes clusters, creating a single virtual cluster that spans across
+multiple physical ones.
 
 ## Example Usage
 

docs/resources/generate.md

@@ -3,12 +3,18 @@
 page_title: "liqo_generate Resource - liqo"
 subcategory: ""
 description: |-
-  Generate peering parameters for remote clusters
+  It retrieves the information concerning the local
+  cluster (i.e., authentication endpoint and token, cluster ID, ...) to use
+  on a different cluster to establish an out-of-band outgoing
+  peering towards the local cluster.
 ---
 
 # liqo_generate (Resource)
 
-Generate peering parameters for remote clusters
+It retrieves the information concerning the local
+cluster (i.e., authentication endpoint and token, cluster ID, ...) to use
+on a different cluster to establish an out-of-band outgoing
+peering towards the local cluster.
 
 
 
@@ -17,7 +23,7 @@ Generate peering parameters for remote clusters
 
 ### Optional
 
-- `liqo_namespace` (String) Namespace where is Liqo installed in provider cluster.
+- `liqo_namespace` (String) Namespace where Liqo is installed in provider cluster.
 
 ### Read-Only
 

docs/resources/offload.md

@@ -3,12 +3,16 @@
 page_title: "liqo_offload Resource - liqo"
 subcategory: ""
 description: |-
-  Offload a namespace.
+  Once a given namespace is selected for offloading, `Offload resource` extends
+  it across the cluster boundaries, through the the automatic creation of
+  twin namespaces in the selected remote clusters.
 ---
 
 # liqo_offload (Resource)
 
-Offload a namespace.
+Once a given namespace is selected for offloading, `Offload resource` extends
+it across the cluster boundaries, through the the automatic creation of
+twin namespaces in the selected remote clusters.
 
 
 
@@ -17,20 +21,20 @@ Offload a namespace.
 
 ### Required
 
-- `namespace` (String) Offload a namespace.
+- `namespace` (String) Namespace to offload.
 
 ### Optional
 
 - `cluster_selector_terms` (Attributes List) Selectors to restrict the set of remote clusters. (see [below for nested schema](#nestedatt--cluster_selector_terms))
 - `namespace_mapping_strategy` (String) Naming strategy used to create the remote namespace.
-- `pod_offloading_strategy` (String) Namespace to offload.
+- `pod_offloading_strategy` (String) High-level constraints with respect to the pod offloading strategy (e.g., _remote_ vs _local_).
 
 <a id="nestedatt--cluster_selector_terms"></a>
 ### Nested Schema for `cluster_selector_terms`
 
 Optional:
 
-- `match_expressions` (Attributes List) A list of cluster selector. (see [below for nested schema](#nestedatt--cluster_selector_terms--match_expressions))
+- `match_expressions` (Attributes List) A list of cluster selectors. (see [below for nested schema](#nestedatt--cluster_selector_terms--match_expressions))
 
 <a id="nestedatt--cluster_selector_terms--match_expressions"></a>
 ### Nested Schema for `cluster_selector_terms.match_expressions`

docs/resources/peer.md

@@ -3,12 +3,18 @@
 page_title: "liqo_peer Resource - liqo"
 subcategory: ""
 description: |-
-  Execute peering.
+  It enables a Liqo peering, i.e., a unidirectional resource and service consumption
+  relationship between two Kubernetes clusters, with one cluster (i.e., the
+  consumer) granted the capability to offload tasks in a remote cluster (i.e., the
+  provider), but not vice versa.
 ---
 
 # liqo_peer (Resource)
 
-Execute peering.
+It enables a Liqo peering, i.e., a unidirectional resource and service consumption
+relationship between two Kubernetes clusters, with one cluster (i.e., the
+consumer) granted the capability to offload tasks in a remote cluster (i.e., the
+provider), but not vice versa.
 
 
 
@@ -17,13 +23,13 @@ Execute peering.
 
 ### Required
 
-- `cluster_authurl` (String) Provider authentication url used for peering.
-- `cluster_id` (String) Provider cluster ID used for peering.
-- `cluster_name` (String) Provider cluster name used for peering.
-- `cluster_token` (String) Provider authentication token used for peering.
+- `cluster_authurl` (String) Provider authentication url.
+- `cluster_id` (String) Provider cluster ID.
+- `cluster_name` (String) Provider cluster name.
+- `cluster_token` (String) Provider authentication token.
 
 ### Optional
 
-- `liqo_namespace` (String) Namespace where is Liqo installed in provider cluster.
+- `liqo_namespace` (String) Namespace where Liqo is installed in the provider cluster.
 
 

go.mod

@@ -5,20 +5,20 @@ go 1.19
 require (
 	github.com/hashicorp/terraform-plugin-framework v0.16.0
 	github.com/hashicorp/terraform-plugin-framework-validators v0.6.0
-	github.com/liqotech/liqo v0.6.0
+	github.com/liqotech/liqo v0.7.1
 	github.com/mitchellh/go-homedir v1.1.0
-	k8s.io/api v0.25.3
-	k8s.io/apimachinery v0.25.3
-	k8s.io/client-go v0.25.3
-	k8s.io/kubectl v0.25.3
-	k8s.io/utils v0.0.0-20220922133306-665eaaec4324
-	sigs.k8s.io/controller-runtime v0.13.0
+	k8s.io/api v0.26.1
+	k8s.io/apimachinery v0.26.1
+	k8s.io/client-go v0.26.1
+	k8s.io/kubectl v0.26.1
+	k8s.io/utils v0.0.0-20221128185143-99ec85e7a448
+	sigs.k8s.io/controller-runtime v0.14.4
 )
 
 require (
 	github.com/Masterminds/goutils v1.1.1 // indirect
-	github.com/Masterminds/semver/v3 v3.1.1 // indirect
-	github.com/Masterminds/sprig/v3 v3.2.2 // indirect
+	github.com/Masterminds/semver/v3 v3.2.0 // indirect
+	github.com/Masterminds/sprig/v3 v3.2.3 // indirect
 	github.com/armon/go-radix v1.0.0 // indirect
 	github.com/aws/aws-sdk-go v1.44.92 // indirect
 	github.com/bgentry/speakeasy v0.1.0 // indirect
@@ -53,14 +53,14 @@ require (
 	github.com/hashicorp/terraform-registry-address v0.0.0-20220623143253-7d51757b572c // indirect
 	github.com/hashicorp/terraform-svchost v0.0.0-20200729002733-f050f53b9734 // indirect
 	github.com/hashicorp/yamux v0.0.0-20180604194846-3520598351bb // indirect
-	github.com/huandu/xstrings v1.3.2 // indirect
+	github.com/huandu/xstrings v1.3.3 // indirect
 	github.com/imdario/mergo v0.3.13 // indirect
 	github.com/jmespath/go-jmespath v0.4.0 // indirect
 	github.com/josharian/intern v1.0.0 // indirect
 	github.com/json-iterator/go v1.1.12 // indirect
 	github.com/mailru/easyjson v0.7.7 // indirect
 	github.com/mattn/go-colorable v0.1.13 // indirect
-	github.com/mattn/go-isatty v0.0.16 // indirect
+	github.com/mattn/go-isatty v0.0.17 // indirect
 	github.com/mitchellh/cli v1.1.4 // indirect
 	github.com/mitchellh/copystructure v1.2.0 // indirect
 	github.com/mitchellh/go-testing-interface v1.14.1 // indirect
@@ -79,22 +79,22 @@ require (
 	github.com/vmihailenco/msgpack/v4 v4.3.12 // indirect
 	github.com/vmihailenco/tagparser v0.1.2 // indirect
 	github.com/zclconf/go-cty v1.10.0 // indirect
-	golang.org/x/crypto v0.1.0 // indirect
-	golang.org/x/net v0.1.0 // indirect
-	golang.org/x/oauth2 v0.0.0-20220909003341-f21342109be1 // indirect
-	golang.org/x/sys v0.1.0 // indirect
-	golang.org/x/term v0.1.0 // indirect
-	golang.org/x/text v0.4.0 // indirect
-	golang.org/x/time v0.0.0-20220922220347-f3bd1da661af // indirect
+	golang.org/x/crypto v0.5.0 // indirect
+	golang.org/x/net v0.7.0 // indirect
+	golang.org/x/oauth2 v0.4.0 // indirect
+	golang.org/x/sys v0.5.0 // indirect
+	golang.org/x/term v0.5.0 // indirect
+	golang.org/x/text v0.7.0 // indirect
+	golang.org/x/time v0.3.0 // indirect
 	google.golang.org/appengine v1.6.7 // indirect
-	google.golang.org/genproto v0.0.0-20220930163606-c98284e70a91 // indirect
-	google.golang.org/grpc v1.50.1 // indirect
+	google.golang.org/genproto v0.0.0-20230110181048-76db0878b65f // indirect
+	google.golang.org/grpc v1.53.0 // indirect
 	google.golang.org/protobuf v1.28.1 // indirect
 	gopkg.in/inf.v0 v0.9.1 // indirect
 	gopkg.in/yaml.v2 v2.4.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 	k8s.io/klog/v2 v2.80.1 // indirect
-	k8s.io/kube-openapi v0.0.0-20220928191237-829ce0c27909 // indirect
+	k8s.io/kube-openapi v0.0.0-20221012153701-172d655c2280 // indirect
 	sigs.k8s.io/json v0.0.0-20220713155537-f223a00ba0e2 // indirect
 	sigs.k8s.io/structured-merge-diff/v4 v4.2.3 // indirect
 	sigs.k8s.io/yaml v1.3.0 // indirect