Skip to content

Commit 3d386b6

Browse files
committed
Update with jhlodin feedback (1)
1 parent e8400ab commit 3d386b6

File tree

1 file changed

+20
-10
lines changed

1 file changed

+20
-10
lines changed

src/current/v25.1/deployment-operations-skills-taxonomy.md

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -21,32 +21,38 @@ Each section includes links to relevant documentation for the listed skills.
2121
Cockroach Labs offers [Professional Services](https://www.cockroachlabs.com/company/professional-services/) that can assist you with getting applications into production faster and more efficiently.
2222
{{site.data.alerts.end}}
2323

24-
## Configuration
24+
## Infrastructure configuration
25+
26+
This section covers how to ensure that your hardware and network are properly configured to meet the performance and connectivity requirements of CockroachDB.
2527

2628
- [Verify vCPU, RAM, storage, and disk IOPS performance]({% link {{ page.version.version }}/recommended-production-settings.md %}#hardware)
2729
- [Configure time synchronization with NTP server]({% link {{ page.version.version }}/deploy-cockroachdb-on-premises.md %}#step-1-synchronize-clocks)
2830
- [Validate network connectivity]({% link {{ page.version.version }}/known-limitations.md %}#cockroachdb-does-not-test-for-all-connection-failure-scenarios)
2931

3032
## Security
3133

34+
This section covers how to secure a CockroachDB deployment, including certificate management, load balancing setup, role-based access control, and data encryption.
35+
3236
- [Create and distribute certificates; initialize cluster]({% link {{ page.version.version }}/deploy-cockroachdb-on-premises.md %}#step-2-generate-certificates)
3337
- [Configure load balancer and direct a workload]({% link {{ page.version.version }}/deploy-cockroachdb-on-premises.md %}#step-6-set-up-load-balancing)
3438
- [Configure RBAC]({% link {{ page.version.version }}/security-reference/authorization.md %})
3539
- [Encryption at rest]({% link {{ page.version.version }}/encryption.md %})
3640

3741
## Cluster maintenance
3842

43+
This section covers how to manage the lifecycle of CockroachDB nodes, including adding and removing nodes, handling outages, performing upgrades or downgrades, and modifying cluster settings.
44+
3945
- [Shut down a node gracefully]({% link {{ page.version.version }}/node-shutdown.md %})
40-
- [Handling unplanned node outages]({% link {{ page.version.version }}/recommended-production-settings.md %}#load-balancing)
41-
- [Adding nodes]({% link {{ page.version.version }}/cockroach-start.md %}#add-a-node-to-a-cluster)
42-
- [Removing nodes]({% link {{ page.version.version }}/node-shutdown.md %}?filters=decommission#remove-nodes)
46+
- [Handle unplanned node outages]({% link {{ page.version.version }}/recommended-production-settings.md %}#load-balancing)
47+
- [Add nodes]({% link {{ page.version.version }}/cockroach-start.md %}#add-a-node-to-a-cluster)
48+
- [Remove nodes]({% link {{ page.version.version }}/node-shutdown.md %}?filters=decommission#remove-nodes)
4349
- [Add a region]({% link {{ page.version.version }}/alter-database.md %}#add-regions-to-a-database)
4450
- [Remove a region]({% link {{ page.version.version }}/alter-database.md %}#drop-region)
4551
- [Rolling upgrades]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#perform-a-patch-upgrade)
4652
- Downgrade a cluster from a [patch version]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#roll-back-a-patch-upgrade)
4753
- Downgrade a cluster from a [major version]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#roll-back-a-major-version-upgrade)
4854
- [Change a cluster setting]({% link {{ page.version.version }}/cluster-settings.md %}#change-a-cluster-setting)
49-
- Cluster repaving involves the following individual skills, which are also used during [rolling upgrades]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#perform-a-patch-upgrade):
55+
- Repave a cluster: cluster repaving involves the following individual skills, which are also used during [rolling upgrades]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#perform-a-patch-upgrade):
5056
1. [Shut down a node gracefully]({% link {{ page.version.version }}/node-shutdown.md %})
5157
1. Detach the [persistent volume]({% link {{ page.version.version }}/kubernetes-overview.md %}#kubernetes-terminology) (a.k.a. persistent disk) from the removed node's virtual machine (VM) (this step is optional but recommended)
5258
1. Delete the removed node's VM
@@ -56,18 +62,22 @@ Cockroach Labs offers [Professional Services](https://www.cockroachlabs.com/comp
5662

5763
## Troubleshooting
5864

65+
This section contains a list of common issues related to SQL performance, cluster stability, memory usage, load balancing, and changefeed lag.
66+
5967
- [SQL response time for specific queries]({% link {{ page.version.version }}/query-behavior-troubleshooting.md %}#query-issues)
6068
- [SQL throughput degradation across the board]({% link {{ page.version.version }}/query-behavior-troubleshooting.md %}#low-throughput)
6169
- [Cluster instability: Dead/suspect nodes]({% link {{ page.version.version }}/cluster-setup-troubleshooting.md %}#node-liveness-issues)
62-
- [Out of memory problems]({% link {{ page.version.version }}/cluster-setup-troubleshooting.md %}#out-of-memory-oom-crash)
70+
- [Out of memory (OOM) problems]({% link {{ page.version.version }}/cluster-setup-troubleshooting.md %}#out-of-memory-oom-crash)
6371
- [Imbalanced cluster load]({% link {{ page.version.version }}/architecture/replication-layer.md %}#load-based-replica-rebalancing)
64-
- [EOF errors]({% link {{ page.version.version }}/cluster-setup-troubleshooting.md %}#client-connection-issues)
72+
- [End of file (EOF) errors]({% link {{ page.version.version }}/cluster-setup-troubleshooting.md %}#client-connection-issues)
6573
- [Changefeed is falling behind]({% link {{ page.version.version }}/advanced-changefeed-configuration.md %}#lagging-ranges)
66-
- [Get a "debug zip" file]({% link {{ page.version.version }}/cockroach-debug-zip.md %})
67-
- [Get a "tsdump" (timeseries dump) file]({% link {{ page.version.version }}/cockroach-debug-tsdump.md %})
74+
- [Gather diagnostic data from a "debug zip" file]({% link {{ page.version.version }}/cockroach-debug-zip.md %})
75+
- [Collect timeseries diagnostic data from a "tsdump" file]({% link {{ page.version.version }}/cockroach-debug-tsdump.md %})
6876

6977
## Disaster recovery
7078

79+
This section covers how to set up and manage backup and restore of your cluster to ensure data recovery in case of failures.
80+
7181
- [Create AWS IAM access key]({% link {{ page.version.version }}/cloud-storage-authentication.md %})
7282
- [Create S3 bucket for backup data]({% link {{ page.version.version }}/use-cloud-storage.md %}#amazon-s3-storage-classes)
7383
- [Full cluster backup to S3]({% link {{ page.version.version }}/take-full-and-incremental-backups.md %}#full-backups)
@@ -77,7 +87,7 @@ Cockroach Labs offers [Professional Services](https://www.cockroachlabs.com/comp
7787
## See also
7888

7989
- [Production Checklist]({% link {{ page.version.version }}/recommended-production-settings.md %})
80-
- [Deploy CockroachDB Manually]({% link {{ page.version.version }}/manual-deployment.md %})
90+
- [Manual Deployment]({% link {{ page.version.version }}/manual-deployment.md %})
8191
- [Deploy a Local Cluster from Binary (Secure)]({% link {{ page.version.version }}/secure-a-cluster.md %})
8292
- [SQL Performance Best Practices]({% link {{ page.version.version }}/performance-best-practices-overview.md %})
8393
- [Performance Tuning Recipes]({% link {{ page.version.version }}/performance-recipes.md %})

0 commit comments

Comments
 (0)