Skip to content
This repository was archived by the owner on Aug 7, 2025. It is now read-only.

Commit 9ec2fcb

Browse files
HarshCaspernik-localstackcloutierMat
authored
update rds docs to mention postgres 17 (#1758)
Co-authored-by: Nikos <nikos.michas@localstack.cloud> Co-authored-by: Mathieu Cloutier <79954947+cloutierMat@users.noreply.github.com>
1 parent a7b2b06 commit 9ec2fcb

File tree

3 files changed

+14
-13
lines changed

3 files changed

+14
-13
lines changed

content/en/references/configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -307,7 +307,7 @@ Please consult the [migration guide]({{< ref "user-guide/aws/lambda#migrating-to
307307
| Variable | Example Values | Description |
308308
| - | - | - |
309309
| `RDS_CLUSTER_ENDPOINT_HOST_ONLY` | `1` (default) \| `0` | Whether the cluster endpoint returns the host only (which is AWS parity). If set to `0` it will return `<host>:<port>`. |
310-
| `RDS_PG_CUSTOM_VERSIONS` | `0` \| `1` (default) | Whether to install and use custom Postgres versions for RDS (or alternatively, use default version 11). |
310+
| `RDS_PG_CUSTOM_VERSIONS` | `0` \| `1` (default) | Whether to install and use custom Postgres versions for RDS (or alternatively, use default version 15). |
311311
| `RDS_MYSQL_DOCKER` | `1` (default) \| `0` | Whether to disable MySQL engines (and use MariaDB instead). MySQL engine for cluster/instances will start in a new docker container. If you have troubles running MySQL in docker, you can disable the feature. |
312312
| `MYSQL_IMAGE` | `mysql:8.0` | Defines a specific MySQL image that should be used when spinning up the MySQL engine. Only available if `RDS_MYSQL_DOCKER` is enabled. |
313313
| `MSSQL_IMAGE` | `mcr.microsoft.com/mssql/server:2022-latest` | Defines a specific image that should be used when spinning up a SQL server engine. |

content/en/user-guide/aws/rds/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -179,12 +179,12 @@ For instance, the `storage-encrypted` flag is returned as configured, but active
179179
### PostgreSQL Engine
180180

181181
When you establish an RDS DB cluster or instance using the `postgres`/`aurora-postgresql` DB engine along with a specified `EngineVersion`, LocalStack will dynamically install and configure the corresponding PostgreSQL version as required.
182-
Presently, you have the option to choose major versions ranging from 11 to 15.
183-
If you select a major version beyond this range, the system will automatically default to version 11.
182+
Presently, you have the option to choose major versions ranging from 11 to 16.
183+
If you select a major version beyond this range, the system will automatically default to version 15.
184184

185185
It's important to note that the selection of minor versions is not available.
186186
The latest major version will be installed within the Docker environment.
187-
If you wish to prevent the installation of customized versions, adjusting the `RDS_PG_CUSTOM_VERSIONS` environment variable to `0` will enforce the use of the default PostgreSQL version 11.
187+
If you wish to prevent the installation of customized versions, adjusting the `RDS_PG_CUSTOM_VERSIONS` environment variable to `0` will enforce the use of the default PostgreSQL version 15.
188188

189189
{{< callout >}}
190190
While the [`DescribeDbCluster`](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusters.html) and [`DescribeDbInstances`](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) APIs will still reflect the initially defined `engine-version`, the actual installed PostgreSQL engine might differ.

content/en/user-guide/aws/stepfunctions/index.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,8 @@ The key components are:
145145
- **Test cases**: Executions of your state machine that use mocked responses.
146146
- **Mock configuration file**: A JSON file that defines test cases, mocked states, and their response payloads.
147147

148-
During execution, each Task state listed in the mock file returns its associated mocked response. States not included in the file continue to invoke the corresponding emulated services, allowing a mix of mocked and real interactions.
148+
During execution, each Task state listed in the mock file returns its associated mocked response.
149+
States not included in the file continue to invoke the corresponding emulated services, allowing a mix of mocked and real interactions.
149150

150151
You can define one or more mocked payloads per Task state.
151152

@@ -166,7 +167,8 @@ Ensure the payload structure in the mocked responses matches what the real servi
166167

167168
### Identify a State Machine for Mocked Integrations
168169

169-
Mocked service integrations apply to specific state machine definitions. The first step is to select the state machine where mocked responses should be applied.
170+
Mocked service integrations apply to specific state machine definitions.
171+
The first step is to select the state machine where mocked responses should be applied.
170172

171173
In this example, we'll use a state machine named `LambdaSQSIntegration`, defined as follows:
172174

@@ -220,7 +222,6 @@ This file contains two top-level sections:
220222
- **StateMachines** – Maps each state machine to its test cases, specifying which states use which mocked responses.
221223
- **MockedResponses** – Defines reusable mock payloads, each identified by a `ResponseID`, which test cases can reference.
222224

223-
224225
#### `StateMachines`
225226

226227
This section specifies the Step Functions state machines to mock, along with their corresponding test cases.
@@ -245,11 +246,11 @@ In the example above:
245246
- **`StateMachineName`**: Must exactly match the name used when the state machine was created in LocalStack.
246247
- **`TestCases`**: Named scenarios that define mocked behavior for specific `Task` states.
247248

248-
Each test case maps `Task` states to mock responses that define their expected behavior.
249+
Each test case maps `Task` states to mock responses that define their expected behavior.
249250

250251
At runtime, if a test case is selected, the state uses the mocked response (if defined); otherwise, it falls back to calling the emulated service.
251252

252-
Below is a complete example of the `StateMachines` section:
253+
Below is a complete example of the `StateMachines` section:
253254

254255
```json
255256
"LambdaSQSIntegration": {
@@ -280,9 +281,10 @@ Each `ResponseID` includes one or more step keys and defines either a `Return` v
280281
In the example above:
281282

282283
- `ResponseID`: A unique identifier used in test cases to reference a specific mock response.
283-
- `step-key`: Indicates the attempt number. For example, `"0"` refers to the first try, while `"1-2"` covers a range of attempts.
284+
- `step-key`: Indicates the attempt number.
285+
For example, `"0"` refers to the first try, while `"1-2"` covers a range of attempts.
284286
- `Return`: Simulates a successful response by returning a predefined payload.
285-
- `Throw`: Simulates a failure by returning an `Error` and an optional `Cause`.
287+
- `Throw`: Simulates a failure by returning an `Error` and an optional `Cause`.
286288

287289
{{< callout >}}
288290
Each entry must have **either** `Return` or `Throw`, but cannot have both.
@@ -432,7 +434,6 @@ This tells LocalStack to apply the corresponding mocked responses from the confi
432434

433435
For example, to run the `BaseCase` test case:
434436

435-
436437
{{< command >}}
437438
$ awslocal stepfunctions start-execution \
438439
--state-machine arn:aws:states:us-east-1:000000000000:stateMachine:LambdaSQSIntegration#BaseCase \
@@ -516,7 +517,7 @@ This will return the full execution history, including entries that indicate how
516517

517518
## Resource Browser
518519

519-
The LocalStack Web Application includes a **Resource Browser** for managing Step Functions state machines.
520+
The LocalStack Web Application includes a **Resource Browser** for managing Step Functions state machines.
520521

521522
To access it, open the LocalStack Web UI in your browser, navigate to the **Resource Browser** section, and click **Step Functions** under **App Integration**.
522523

0 commit comments

Comments
 (0)