[CN-1037]: add doc for scaling and upgrading (#145)

check-links-playbook.yml

@@ -27,6 +27,9 @@ content:
   - url: https://github.com/hazelcast-guides/spring-boot-sample
     branches: master
     start_paths: docs
+  - url: https://github.com/hazelcast-guides/sql_basics_on_viridian
+    branches: master
+    start_paths: docs   
   - url: https://github.com/hazelcast-guides/serverless-fraud-detection
     branches: master
     start_paths: docs
@@ -137,7 +140,7 @@ content:
   - url: https://github.com/hazelcast-guides/hazelcast-platform-operator-external-backup-restore
     branches: master
     start_path: docs
-  - url: https://github.com/hazelcast/hazelcast-commandline-client
+  - url: https://github.com/hazelcast/clc-docs
     branches: main
     start_path: docs
 ui: 

docs/modules/ROOT/examples/hazelcast-5.2.4.yaml

@@ -0,0 +1,8 @@
+apiVersion: hazelcast.com/v1alpha1
+kind: Hazelcast
+metadata:
+  name: hazelcast-sample
+spec:
+  clusterSize: 3
+  repository: 'docker.io/hazelcast/hazelcast'
+  version: '5.2.4-slim'

docs/modules/ROOT/nav.adoc

@@ -34,5 +34,6 @@
 
 .Reference
 // Configuration options/spec files/any other reference docs
+* xref:scaling-upgrading.adoc[Scaling & Upgrading]
 * xref:phone-homes.adoc[Phone Homes]
 * xref:api-ref.adoc[API References]

docs/modules/ROOT/pages/scaling-upgrading.adoc

@@ -0,0 +1,37 @@
+= Scaling and Upgrading a Hazelcast Deployment
+
+To scale an existing Hazelcast deployment, use the following command:
+
+[source,shell]
+----
+kubectl scale hazelcast <name> --replicas <replica-count>
+----
+
+Example:
+
+[source,shell]
+----
+kubectl scale hazelcast hazelcast-sample --replicas 5
+----
+
+== Upgrading
+
+To upgrade your existing deployment to a newer version, you need to update `spec.version` field and re-apply. For example:
+
+Assuming the following is the existing configuration:
+
+[source,yaml,subs="attributes+"]
+----
+include::ROOT:example$/hazelcast-5.2.4.yaml[]
+----
+
+and you want to upgrade your hazelcast version to {page-latest-supported-hazelcast}, you need to apply the following:
+
+
+Assuming the following is the existing configuration:
+
+[source,yaml,subs="attributes+"]
+----
+include::ROOT:example$/hazelcast.yaml[]
+----
+