Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update kbcli cluster create, yaml, and monitoring docs in release-1.0 #8729

Conversation

michelle-0808
Copy link
Contributor

  1. Updated the kbcli cluster create cli command examples
  2. Updated the creating cluster yaml examples
  3. Added ApeCloud MySQL, MySQL, PostgreSQL, Redis examples for creating PodMonitor
  4. Deleted "enabledLogs" field in the monitoring docs. The "enabledLogs" field in other docs will be deleted in the future.

@michelle-0808 michelle-0808 self-assigned this Dec 30, 2024
@michelle-0808 michelle-0808 requested review from shanshanying and a team as code owners December 30, 2024 08:14
@github-actions github-actions bot added the size/XXL Denotes a PR that changes 1000+ lines. label Dec 30, 2024
docs/user_docs/kubeblocks-for-qdrant/manage-qdrant.md Outdated Show resolved Hide resolved
@@ -107,69 +107,77 @@ KubeBlocks supports creating two types of Redis clusters: Standalone and Replica

<TabItem value="kubectl" label="kubectl" default>

KubeBlocks implements a `Cluster` CRD to define a cluster. Here is an example of creating a Standalone.
KubeBlocks implements a `Cluster` CRD to define a cluster. Here is an example of creating a Replcation. KubeBlocks also supports creating a Redis cluster in other modes. You can refer to the examples provided in the [GitHub repository](https://github.com/apecloud/kubeblocks-addons/tree/main/examples/redis).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Replication here refers to ?

@@ -135,8 +135,6 @@ spec:
componentSpecs:
- name: postgresql
componentDefRef: postgresql
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

componentDefRef is deprecated since v1.0. pls check.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

componentDefRef --> componentDef

```bash
kbcli cluster create mycluster --cluster-definition apecloud-mysql --set replicas=3 --topology-keys null --namespace demo
```
If you only have one node for deploying a RaftGroup Cluster, you can configure the cluster affinity by setting `--pod-anti-afffinity`, `--tolerations`, and `--topology-keys` when creating a RaftGroup Cluster. But you should note that for a production environment, it is not recommended to deploy all replicas on one node, which may decrease the cluster availability.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Provide an example.

| `spec.componentSpecs.replicas` | It specifies the number of replicas of the component. |
| `spec.componentSpecs.resources` | It specifies the resource requirements of the component. |
| `spec.terminationPolicy` | It is the policy of cluster termination. Valid values are `DoNotTerminate`, `Delete`, `WipeOut`. For the detailed definition, you can refer to [Termination Policy](./delete-kafka-cluster.md#termination-policy). |
| `spec.clusterDef` | It specifies the name of the ClusterDefinition to use when creating a Cluster. **Note: DO NOT UPDATE THIS FIELD**. The value must be must be `kafaka` to create a Kafka Cluster. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

kafaka => kafka

@apecloud-bot apecloud-bot added the approved PR Approved Test label Jan 6, 2025
@apecloud-bot apecloud-bot removed the approved PR Approved Test label Jan 7, 2025
@apecloud-bot apecloud-bot added the approved PR Approved Test label Jan 7, 2025
@michelle-0808 michelle-0808 merged commit 0c9a974 into main Jan 7, 2025
25 checks passed
@michelle-0808 michelle-0808 deleted the support/update-kbcli-cluster-create-and-monitoring-docs-1.0 branch January 7, 2025 09:45
@github-actions github-actions bot added this to the Release 0.9.2 milestone Jan 7, 2025
@michelle-0808
Copy link
Contributor Author

/cherry-pick release-1.0-beta

@apecloud-bot
Copy link
Collaborator

🤖 says: cherry pick action finished successfully 🎉!
See: https://github.com/apecloud/kubeblocks/actions/runs/12662526148

apecloud-bot pushed a commit that referenced this pull request Jan 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved PR Approved Test size/XXL Denotes a PR that changes 1000+ lines.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants