fleet/tools/mysql-replica-testing/README.md
Lucas Manuel Rodriguez 57816592ba
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 16:52:05 -07:00

28 lines
553 B
Markdown

# 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
```