Add more examples to quickstart

Author: cristianrgreco

docs/quickstart.md

@@ -27,8 +27,14 @@ describe("Redis", () => {
   let redisClient: RedisClientType;
 
   beforeAll(async () => {
-    container = await new GenericContainer("redis").withExposedPorts(6379).start();
-    redisClient = createClient({ url: `redis://${container.getHost()}:${container.getMappedPort(6379)}` });
+    container = await new GenericContainer("redis")
+      .withExposedPorts(6379)
+      .start();
+    
+    redisClient = createClient({ 
+      url: `redis://${container.getHost()}:${container.getMappedPort(6379)}` 
+    });
+    
     await redisClient.connect();
   });
 
@@ -46,7 +52,63 @@ describe("Redis", () => {
 
 Run the test, and after a few seconds, it passes!
 
-Why did it take a few seconds? Because your container runtime likely had to pull the image first. If you run the test again, it'll likely pass much faster.
+Why did it take a few seconds? Because your container runtime likely had to pull the image first. If you run the test again, it'll run faster.
+
+## Global setup
+
+If you have a lot of tests that require a Redis container, you might not want to spin up 100s of Redis containers. 
+
+In this case a common pattern is to set the container up globally, and reuse it in your tests. Here's an example using Vitest:
+
+```ts
+// setup.js
+
+import { createClient, RedisClientType } from "redis";
+import { GenericContainer, StartedTestContainer } from "testcontainers";
+
+export async function setup() {
+  globalThis.redisContainer = await new GenericContainer("redis")
+    .withExposedPorts(6379)
+    .start();
+  
+  globalThis.redisClient = createClient({ 
+    url: `redis://${redisContainer.getHost()}:${redisContainer.getMappedPort(6379)}` 
+  });
+  
+  await redisClient.connect();
+}
+
+export async function teardown() {
+  await globalThis.redisClient.disconnect();
+  await globalThis.redisContainer.stop();
+}
+```
+
+The Vite configuration:
+
+```ts
+// vite.config.js
+
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  test: {
+    setupFiles: "./setup.js",
+  }
+});
+```
+
+And how to reference the container/client in your tests:
+
+```ts
+it("should set and retrieve a value from Redis", async () => {
+  await globalThis.redisClient.set("key", "test-value");
+  const result = await globalThis.redisClient.get("key");
+  expect(result).toBe("test-value");
+});
+```
+
+## Logging
 
 It would be nice to see what Testcontainers is doing while the test is running. You can enable all debug logging by setting the `DEBUG` environment variable. For example: