Skip to content

Commit d310ba9

Browse files
authored
chore: fix rocks terminology (#417)
1 parent 6c09910 commit d310ba9

File tree

7 files changed

+13
-13
lines changed

7 files changed

+13
-13
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ juju relate mysql-k8s:mysql wordpress-k8s:db
9898
**Note:** The endpoint `mysql-root` provides the same legacy interface `mysql` with MySQL root-level privileges. It is NOT recommended to use it from security point of view.
9999

100100
## OCI Images
101-
This charm uses pinned and tested version of the [charmed-mysql](https://github.com/canonical/charmed-mysql-rock/pkgs/container/charmed-mysql) ROCK image.
101+
This charm uses pinned and tested version of the [charmed-mysql](https://github.com/canonical/charmed-mysql-rock/pkgs/container/charmed-mysql) rock.
102102

103103
## Security
104104
Security issues in the Charmed MySQL K8s Operator can be reported through [LaunchPad](https://wiki.ubuntu.com/DebuggingSecurity#How%20to%20File). Please do not file GitHub issues about security issues.

docs/explanation/e-architecture.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,13 @@ And if you run `kubectl describe pod mysql-k8s-0`, all the containers will have
2727
<a name="hld"></a>
2828
## HLD (High Level Design)
2929

30-
The "Charmed MySQL K8s" (`workload` container) based on `mysql-image` resource defined in the [charm metadata.yaml](https://github.com/canonical/mysql-k8s-operator/blob/main/metadata.yaml). It is an official Canonical "[charmed-mysql](https://github.com/canonical/charmed-mysql-rock)" [OCI/ROCK](https://ubuntu.com/server/docs/rock-images/introduction) image, which is recursively based on Canonical SNAP “[charmed-mysql](https://snapcraft.io/charmed-mysql)” (read more about the SNAP details [here](/t/11756)).
30+
The "Charmed MySQL K8s" (`workload` container) based on `mysql-image` resource defined in the [charm metadata.yaml](https://github.com/canonical/mysql-k8s-operator/blob/main/metadata.yaml). It is an official Canonical "[charmed-mysql](https://github.com/canonical/charmed-mysql-rock)" [OCI/Rock](https://ubuntu.com/server/docs/rock-images/introduction) image, which is recursively based on Canonical SNAP “[charmed-mysql](https://snapcraft.io/charmed-mysql)” (read more about the SNAP details [here](/t/11756)).
3131

3232
[Charmcraft](https://juju.is/docs/sdk/install-charmcraft) uploads an image as a [charm resource](https://charmhub.io/mysql-k8s/resources/mysql-image) to [Charmhub](https://charmhub.io/mysql-k8s) during the [publishing](https://github.com/canonical/mysql-k8s-operator/blob/main/.github/workflows/release.yaml#L40-L53), as described in the [Juju SDK How-to guides](https://juju.is/docs/sdk/publishing).
3333

3434
The charm supports Juju deploymed to all Kubernetes environments: [MicroK8s](https://microk8s.io/), [Charmed Kubernetes](https://ubuntu.com/kubernetes/charmed-k8s), [GKE](https://charmhub.io/mysql-k8s/docs/h-deploy-gke), [Amazon EKS](https://aws.amazon.com/eks/), ...
3535

36-
The OCI/ROCK ships the following components:
36+
The OCI/Rock ships the following components:
3737

3838
* MySQL Community Edition (based on SNAP "[charmed-mysql](/t/11756)")
3939
* MySQL Router (based on SNAP "[charmed-mysql](/t/11756)")
@@ -43,7 +43,7 @@ The OCI/ROCK ships the following components:
4343
* Prometheus MySQL Router Exporter (based on SNAP "[charmed-mysql](/t/11756)")
4444
* Prometheus Grafana dashboards and Loki alert rules are part of the charm revision and missing in SNAP.
4545

46-
SNAP-based ROCK images guaranties the same components versions and functionality between VM and K8s charm flavors.
46+
SNAP-based rocks guarantee the same components versions and functionality between VM and K8s charm flavors.
4747

4848
Pebble runs layers of all the currently enabled services, e.g. monitoring, backups, etc:
4949
```shell
@@ -78,7 +78,7 @@ All `exporter` services are activated after the relation with [COS Monitoring](/
7878
7979
> **:warning: Important:** all pebble resources must be executed under the proper user (defined in user:group options of pebble layer)!
8080
81-
The ROCK "charmed-mysql" also ships list of tools used by charm:
81+
The rock "charmed-mysql" also ships list of tools used by charm:
8282
* `mysql` - mysql client to connect `mysqld`.
8383
* `mysqlsh` - new [mysql-shell](https://dev.mysql.com/doc/mysql-shell/8.0/en/) client to configure MySQL cluster.
8484
* `xbcloud` - a tool to download and upload full or part of xbstream archive from/to the cloud.
@@ -136,7 +136,7 @@ Accordingly to the [Juju SDK](https://juju.is/docs/sdk/event): “an event is a
136136

137137
For this charm, the following events are observed:
138138

139-
1. [mysql_pebble_ready](https://juju.is/docs/sdk/container-name-pebble-ready-event): informs charm about the availability of the ROCK "charmed-mysql"-based `workload` K8s container. Also performs basic preparations to bootstrap the cluster on the first leader (or join the already configured cluster).
139+
1. [mysql_pebble_ready](https://juju.is/docs/sdk/container-name-pebble-ready-event): informs charm about the availability of the rock "charmed-mysql"-based `workload` K8s container. Also performs basic preparations to bootstrap the cluster on the first leader (or join the already configured cluster).
140140
2. [leader-elected](https://juju.is/docs/sdk/leader-elected-event): generate all the secrets to bootstrap the cluster.
141141
5. [config_changed](https://juju.is/docs/sdk/config-changed-event): usually fired in response to a configuration change using the GUI or CLI. Create and set default cluster and cluster-set names in the peer relation databag (on the leader only).
142142
6. [update-status](https://juju.is/docs/sdk/update-status-event): Takes care of workload health checks.

docs/how-to/h-develop/h-develop-migratedataby/h-develop-backuprestore.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Before the data migration check all [limitations of the modern Charmed MySQL K8s
1111
The approach:
1212

1313
* retrieve root/admin level credentials from legacy charm. See examples [here](/t/11992).
14-
* install [Percona XtraBackup for MySQL](https://www.percona.com/software/mysql-database/percona-xtrabackup) inside the old charm OR remotely. Ensure version is compatible with xtrabackup in `Charmed MySQL K8s` revision you are going to deploy! See [examples](https://docs.percona.com/percona-xtrabackup/8.0/installation.html). BTW, you can use `charmed-mysql` [SNAP](https://snapcraft.io/charmed-mysql)/[ROCK](https://github.com/canonical/charmed-mysql-rock) directly (more details [here](/t/11757#hld)).
14+
* install [Percona XtraBackup for MySQL](https://www.percona.com/software/mysql-database/percona-xtrabackup) inside the old charm OR remotely. Ensure version is compatible with xtrabackup in `Charmed MySQL K8s` revision you are going to deploy! See [examples](https://docs.percona.com/percona-xtrabackup/8.0/installation.html). BTW, you can use `charmed-mysql` [SNAP](https://snapcraft.io/charmed-mysql)/[rock](https://github.com/canonical/charmed-mysql-rock) directly (more details [here](/t/11757#hld)).
1515
* configure storage for database backup (local or remote, S3-based is recommended).
1616
* create a first full logical backup during the off-peak, [example of backup command](https://github.com/canonical/mysql-k8s-operator/blob/bc5f255e579033e2d501c3412d87913593ad62a3/lib/charms/mysql/v0/mysql.py#L2160-L2185).
1717
* [restore the foreign backup](/t/9661) to Charmed MySQL Lab installation.

docs/reference/r-releases-group/r-releases-rev113.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Canonica Data issues are now public on both [Jira](https://warthogs.atlassian.ne
3030
* CLI mysql-shell updated to "8.0.34-0ubuntu0.22.04.1~ppa1"
3131
* Backup tools xtrabackup/xbcloud updated to "8.0.34-29"
3232
* The Prometheus mysqld-exporter is "0.14.0-0ubuntu0.22.04.1~ppa1"
33-
* K8s charms [based on our](https://github.com/orgs/canonical/packages?tab=packages&q=charmed) ROCK OCI (Ubuntu LTS “22.04” - ubuntu:22.04-based) based on SNAP revision 69
33+
* K8s charms [based on our](https://github.com/orgs/canonical/packages?tab=packages&q=charmed) rock (Ubuntu LTS “22.04” - ubuntu:22.04-based) based on SNAP revision 69
3434
* Principal charms supports the latest LTS series “22.04” only
3535
* Subordinate charms support LTS “22.04” and “20.04” only
3636

docs/reference/r-releases-group/r-releases-rev75.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Dear community, this is to inform you that new Canonical Charmed MySQL K8s charm
2222
## What is inside the charms:
2323

2424
* Charmed MySQL K8s charm ships the latest MySQL “8.0.32-0ubuntu0.22.04.2”
25-
* K8s charms [based on our](https://github.com/orgs/canonical/packages?tab=packages&q=charmed) ROCK OCI (Ubuntu LTS “22.04” - ubuntu:22.04-based)
25+
* K8s charms [based on our](https://github.com/orgs/canonical/packages?tab=packages&q=charmed) rock (Ubuntu LTS “22.04” - ubuntu:22.04-based)
2626
* Principal charms supports the latest LTS series “22.04” only.
2727
* Subordinate charms support LTS “22.04” and “20.04” only.
2828

@@ -33,7 +33,7 @@ Compatibility with legacy charms:
3333

3434
Please contact us, see details below, if you are considering migrating from other “legacy” charms not mentioned above. Additionally:
3535
* Tracks description:
36-
* Charm MySQL K8s charm follows the SNAP track “8.0” (through repacked ROCK/OCI image).
36+
* Charm MySQL K8s charm follows the SNAP track “8.0” (through repacked rock/OCI image).
3737
* No “latest” track in use (no surprises in tracking “latest/stable”)!
3838
* Charmed MySQL K8s charms provide [legacy charm](/t/11236) through “latest/stable”.
3939
* Charm lifecycle flowchart diagrams: [MySQL](https://github.com/canonical/mysql-k8s-operator/tree/main/docs/reference).

docs/reference/r-releases-group/r-releases-rev99.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Canonical Data issues are now public on both [Jira](https://warthogs.atlassian.n
4444
* CLI mysql-shell updated to "8.0.34-0ubuntu0.22.04.1~ppa1"
4545
* Backup tools xtrabackup/xbcloud updated to "8.0.34-29"
4646
* The Prometheus mysqld-exporter is "0.14.0-0ubuntu0.22.04.1~ppa1"
47-
* K8s charms [based on our](https://github.com/orgs/canonical/packages?tab=packages&q=charmed) ROCK OCI (Ubuntu LTS “22.04” - ubuntu:22.04-based)
47+
* K8s charms [based on our](https://github.com/orgs/canonical/packages?tab=packages&q=charmed) rock (Ubuntu LTS “22.04” - ubuntu:22.04-based)
4848
* Principal charms supports the latest LTS series “22.04” only.
4949
* Subordinate charms support LTS “22.04” and “20.04” only.
5050

docs/reference/r-requirements.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,11 @@ Make sure your machine meets the following requirements:
2121
- 8GB of RAM.
2222
- 2 CPU threads.
2323
- At least 20GB of available storage.
24-
- Access to the internet for downloading the required OCI/ROCKs and charms.
24+
- Access to the internet for downloading the required OCI/Rocks and charms.
2525

2626
## Supported architectures
2727

28-
The charm is based on [ROCK OCI](https://github.com/canonical/charmed-mysql-rock) named "[charmed-mysql](https://github.com/canonical/charmed-mysql-rock/pkgs/container/charmed-mysql)", which is recursively based on SNAP "[charmed-mysql](https://snapcraft.io/charmed-mysql)", which is currently available for `amd64` only! The architecture `arm64` support is planned. Please [contact us](https://chat.charmhub.io/charmhub/channels/data-platform) if you are interested in new architecture!
28+
The charm is based on [Rock OCI](https://github.com/canonical/charmed-mysql-rock) named "[charmed-mysql](https://github.com/canonical/charmed-mysql-rock/pkgs/container/charmed-mysql)", which is recursively based on SNAP "[charmed-mysql](https://snapcraft.io/charmed-mysql)", which is currently available for `amd64` only! The architecture `arm64` support is planned. Please [contact us](https://chat.charmhub.io/charmhub/channels/data-platform) if you are interested in new architecture!
2929

3030
<a name="mysql-gr-limits"></a>
3131
## MySQL Group Replication requirements

0 commit comments

Comments
 (0)