diff --git a/sites/platform/src/add-services/mysql/_index.md b/sites/platform/src/add-services/mysql/_index.md index 1335e6f062..622e5058a1 100644 --- a/sites/platform/src/add-services/mysql/_index.md +++ b/sites/platform/src/add-services/mysql/_index.md @@ -340,11 +340,12 @@ You can also see a guide on how to [convert the `{{< vendor/prefix >}}_RELATIONS You can configure your MySQL service in the [services configuration](/add-services/_index.md) with the following options: -| Name | Type | Version | Description | -| ------------ | ----------------------- | ---------------------------------- | ----------- | -| `schemas` | An array of `string`s | 10.0+ | All databases to be created. Defaults to a single `main` database. | -| `endpoints` | An endpoints dictionary | 10.0+ | Endpoints with their permissions. See [multiple databases](#multiple-databases). | -| `properties` | A properties dictionary | MariaDB: 10.1+; Oracle MySQL: 8.0+ | Additional properties for the database. Equivalent to using a `my.cnf` file. See [property options](#configure-the-database). | +| Name | Type | Version | Description | +| ------------------ | -------------------------- | ---------------------------------- | ----------- | +| `schemas` | An array of `string`s | 10.0+ | All databases to be created. Defaults to a single `main` database. | +| `endpoints` | An endpoints dictionary | 10.0+ | Endpoints with their permissions. See [multiple databases](#multiple-databases). | +| `properties` | A properties dictionary | MariaDB: 10.1+; Oracle MySQL: 8.0+ | Additional properties for the database. Equivalent to using a `my.cnf` file. See [property options](#configure-the-database). | +| `rotate_passwords` | A boolean | 10.3+ | Allows disabling passwords rotation. Defaults to `true`. | Example configuration: @@ -756,6 +757,14 @@ you get an automatically generated password, similarly to when you create [multiple databases](#multiple-databases). Note that you can't customize these automatically generated passwords. +{{% note theme="warning" %}} +By default, the generated password will rotate on a regular +basis. Your applications MUST use the passwords from the +relationships, as the password _is_ going to change. Set +`rotate_passwords` to `false` if you wish to change this default +behavior. +{{% /note %}} + After your custom endpoints are exposed as relationships in your [app configuration](/create-apps/_index.md), you can retrieve the password for each endpoint through the `{{% vendor/prefix %}}_RELATIONSHIPS` [environment variable](/development/variables/use-variables.md#use-provided-variables) diff --git a/sites/upsun/src/add-services/mysql/_index.md b/sites/upsun/src/add-services/mysql/_index.md index ec99676ac0..bcd670cca4 100644 --- a/sites/upsun/src/add-services/mysql/_index.md +++ b/sites/upsun/src/add-services/mysql/_index.md @@ -512,11 +512,12 @@ You can also see a guide on how to [convert the `{{< vendor/prefix >}}_RELATIONS You can configure your MySQL service in the [services configuration](../_index.md) with the following options: -| Name | Type | Version | Description | -| ------------ | ----------------------- | ---------------------------------- | ----------- | -| `schemas` | An array of `string`s | 10.0+ | All databases to be created. Defaults to a single `main` database. | -| `endpoints` | An endpoints dictionary | 10.0+ | Endpoints with their permissions. See [multiple databases](#multiple-databases). | -| `properties` | A properties dictionary | MariaDB: 10.1+; Oracle MySQL: 8.0+ | Additional properties for the database. Equivalent to using a `my.cnf` file. See [property options](#configure-the-database). | +| Name | Type | Version | Description | +| ------------------ | -------------------------- | ---------------------------------- | ----------- | +| `schemas` | An array of `string`s | 10.0+ | All databases to be created. Defaults to a single `main` database. | +| `endpoints` | An endpoints dictionary | 10.0+ | Endpoints with their permissions. See [multiple databases](#multiple-databases). | +| `properties` | A properties dictionary | MariaDB: 10.1+; Oracle MySQL: 8.0+ | Additional properties for the database. Equivalent to using a `my.cnf` file. See [property options](#configure-the-database). | +| `rotate_passwords` | A boolean | 10.3+ | Allows disabling passwords rotation. Defaults to `true`. | Example configuration: @@ -746,6 +747,14 @@ you get an automatically generated password, similarly to when you create [multiple databases](#multiple-databases). Note that you can't customize these automatically generated passwords. +{{% note theme="warning" %}} +By default, the generated password will rotate on a regular +basis. Your applications MUST use the passwords from the +relationships, as the password _is_ going to change. Set +`rotate_passwords` to `false` if you wish to change this default +behavior. +{{% /note %}} + After your custom endpoints are exposed as relationships in your [app configuration](../../create-apps/_index.md), you can retrieve the password for each endpoint through the `{{% vendor/prefix %}}_RELATIONSHIPS` [environment variable](../../development/variables/use-variables.md#use-provided-variables)