mirror of
https://github.com/renovatebot/renovate.git
synced 2026-11-02 02:29:51 +00:00
Jamie Tanna
210bf42b89
As we've got some duplication, we should centralise this into a specific page under "tool calling".
102 lines
3.4 KiB
Markdown
102 lines
3.4 KiB
Markdown
This datasource returns the database engine versions available for use on [AWS RDS](https://aws.amazon.com/rds/) via the AWS API.
|
|
|
|
Generally speaking, all publicly released database versions are available for use on RDS.
|
|
However, new versions may not be available on RDS for a few weeks or months after their release while AWS tests them.
|
|
In addition, AWS may pull existing versions if serious problems arise during their use.
|
|
|
|
!!! warning
|
|
The default versioning of the `aws-rds` datasource is _not_ compatible with [AWS Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html)!
|
|
If you use AWS Aurora, you must set your own custom versioning.
|
|
Scroll down to see an example.
|
|
|
|
### AWS API configuration
|
|
|
|
See [Calling AWS Services from Renovate](../../../calling-aws-services.md) for how to configure your credentials.
|
|
|
|
```json {title="Minimal IAM privileges needed for this datasource" configType=none}
|
|
{
|
|
"Sid": "AllowDBEngineVersionLookup",
|
|
"Effect": "Allow",
|
|
"Action": ["rds:DescribeDBEngineVersions"],
|
|
"Resource": "*"
|
|
}
|
|
```
|
|
|
|
Read the [AWS RDS IAM reference](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonrds.html) for more information.
|
|
|
|
### Usage
|
|
|
|
Because Renovate has no manager for the AWS RDS datasource, you need to help Renovate by configuring the custom manager to identify the RDS dependencies you want updated.
|
|
|
|
When configuring the custom manager, you have to pass a [filter](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-rds/interfaces/describedbengineversionscommandinput.html#filters) as minified JSON as the `packageName`.
|
|
For example:
|
|
|
|
```yaml
|
|
# Getting the latest supported MySQL 5.7 version from RDS as a filter would look like:
|
|
|
|
[
|
|
{
|
|
"Name": "engine",
|
|
"Values": [ "mysql" ]
|
|
},
|
|
{
|
|
"Name": "engine-version",
|
|
"Values": [ "5.7" ]
|
|
}
|
|
]
|
|
|
|
# In order to use it with this datasource, you have to minify it:
|
|
|
|
[{"Name":"engine","Values":["mysql"]},{"Name":"engine-version","Values":["5.7"]}]
|
|
```
|
|
|
|
```json title="Using a custom manager to configure this datasource"
|
|
{
|
|
"customManagers": [
|
|
{
|
|
"customType": "regex",
|
|
"managerFilePatterns": ["**.yaml"],
|
|
"matchStrings": [
|
|
".*rdsFilter=(?<packageName>.+?)[ ]*\n[ ]*(?<depName>[a-zA-Z0-9-_:]*)[ ]*?:[ ]*?[\"|']?(?<currentValue>[.\\d]+)[\"|']?.*"
|
|
],
|
|
"datasourceTemplate": "aws-rds"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
The configuration above matches every YAML file, and recognizes these lines:
|
|
|
|
```yaml
|
|
spec:
|
|
# rdsFilter=[{"Name":"engine","Values":["mysql"]},{"Name":"engine-version","Values":["5.7"]}]
|
|
engineVersion: 5.7.34
|
|
```
|
|
|
|
#### Using Terraform, `aws-rds` datasource and Aurora MySQL
|
|
|
|
Here is the Renovate configuration to use Terraform, `aws-rds` and Aurora MySQL:
|
|
|
|
```json
|
|
{
|
|
"customManagers": [
|
|
{
|
|
"description": "Update RDS",
|
|
"customType": "regex",
|
|
"managerFilePatterns": ["/.+\\.tf$/"],
|
|
"matchStrings": [
|
|
"\\s*#\\s*renovate:\\s*rdsFilter=(?<packageName>.+?) depName=(?<depName>.*) versioning=(?<versioning>.*)\\s*.*_version\\s*=\\s*\"(?<currentValue>.*)\""
|
|
],
|
|
"datasourceTemplate": "aws-rds"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
The above configuration is an example of updating an AWS RDS version inside a Terraform file, using a custom manager.
|
|
|
|
```
|
|
# renovate:rdsFilter=[{"Name":"engine","Values":["aurora-mysql"]},{"Name":"engine-version","Values":["8.0"]}] depName=aurora-mysql versioning=loose
|
|
engine_version = "8.0.mysql_aurora.3.05.2"
|
|
```
|