fleet/tools/mysql-replica-testing/README.md

# MySQL Replica Testing

This directory contains scripts to run/test a local Fleet instance with a MySQL Read Replica.

## Run MySQL Main and Read Replica Docker Images

> Run all commands from fleet's root repository directory.

```sh
docker-compose -f ./tools/mysql-replica-testing/docker-compose.yml up
```

## Configure MySQL Main and Read Replica

```sh
# Configure the main and read replica for replication.
make db-replica-setup

# Reset the main database.
make db-replica-reset
```

## Run Fleet with Read Replica

```sh
make db-replica-run
```
Add read replica testing helpers and fix non-sso login bug (#4908) not set on the INSERT. - OUT: Only sets the ID on the passed session and returns it. (`CreatedAt`, `AccessedAt`, are not set.) New version: ```go func (ds Datastore) NewSession(ctx context.Context, userID uint, sessionKey string) (fleet.Session, error) { sqlStatement := ` INSERT INTO sessions ( user_id, ` + "`key`" + ` ) VALUES(?,?) ` result, err := ds.writer.ExecContext(ctx, sqlStatement, userID, sessionKey) if err != nil { return nil, ctxerr.Wrap(ctx, err, "inserting session") } id, _ := result.LastInsertId() // cannot fail with the mysql driver return ds.sessionByID(ctx, ds.writer, uint(id)) } ``` - IN: Define arguments that are truly used when creating a session. - OUT: Load and return the fleet.Session struct with all values set (using the `ds.writer` to support read replicas correctly). PS: The new `NewSession` version mimics what we already do with other entities, like policies (`Datastore.NewGlobalPolicy`). 2022-04-04 23:52:05 +00:00			`# MySQL Replica Testing`

			`This directory contains scripts to run/test a local Fleet instance with a MySQL Read Replica.`

			`## Run MySQL Main and Read Replica Docker Images`

			`> Run all commands from fleet's root repository directory.`

			```sh
			`docker-compose -f ./tools/mysql-replica-testing/docker-compose.yml up`
			```

			`## Configure MySQL Main and Read Replica`

			```sh
			`# Configure the main and read replica for replication.`
			`make db-replica-setup`

			`# Reset the main database.`
			`make db-replica-reset`
			```

			`## Run Fleet with Read Replica`

			```sh
			`make db-replica-run`
			```