test(e2e): add Playwright E2E tests

Implements end-to-end tests using Playwright for UI testing:
- Add E2E test infrastructure with Playwright
- Create docker-compose.e2e.yml for UI testing environment
- Add homepage tests validating ShellHub UI loads correctly

Author: gustavosbarreto

ssh/server/channels/session.go

@@ -290,6 +290,11 @@ func DefaultSessionHandler() gliderssh.ChannelHandler {
 							reject(nil, "failed to recover the session dimensions")
 						}
 
+						logger.WithFields(log.Fields{
+							"width":  dimensions.Width,
+							"height": dimensions.Height,
+						}).Debug("window-change request received from client")
+
 						sess.Event(req.Type, dimensions, seat) //nolint:errcheck
 					case AuthRequestOpenSSHRequest:
 						gliderssh.SetAgentRequested(ctx)

tests/docker-compose.e2e.yml

@@ -0,0 +1,68 @@
+version: "3.7"
+
+services:
+  ssh:
+    image: ssh:test
+    build:
+      context: .
+      dockerfile: ssh/Dockerfile
+      target: production
+    healthcheck:
+      interval: 5s
+      start_period: 10s
+      retries: 20
+    ports: []
+  api:
+    image: api:test
+    build:
+      context: .
+      dockerfile: api/Dockerfile
+      target: production
+    healthcheck:
+      interval: 5s
+      start_period: 10s
+      retries: 20
+    ports: []
+  gateway:
+    image: gateway:test
+    build:
+      context: .
+      dockerfile: gateway/Dockerfile
+      target: production
+    healthcheck:
+      interval: 5s
+      start_period: 10s
+      retries: 20
+    ports: []
+  ui:
+    image: ui:test
+    build:
+      context: .
+      dockerfile: ui/Dockerfile
+      target: production
+    healthcheck:
+      interval: 5s
+      start_period: 10s
+      retries: 20
+    ports: []
+  mongo:
+    image: mongo:4.4.29
+    healthcheck:
+      test: 'test $$(echo "rs.initiate({ _id: ''rs'', members: [ { _id: 0, host: ''mongo:27017'' } ] }).ok || rs.status().ok" | mongo --quiet) -eq 1'
+      interval: 5s
+      start_period: 10s
+      retries: 20
+    command: ["--replSet", "rs", "--bind_ip_all"]
+    ports: []
+  redis:
+    image: redis
+    command: ["redis-server", "--appendonly", "no", "--save", "\"\""]
+    ports: []
+
+secrets:
+  ssh_private_key:
+    file: ./tests/ssh_private_key
+  api_private_key:
+    file: ./tests/api_private_key
+  api_public_key:
+    file: ./tests/api_public_key

docker-compose.test.yml tests/docker-compose.integration.ymldocker-compose.test.yml renamed to tests/docker-compose.integration.yml

@@ -6,7 +6,7 @@ services:
     build:
       context: .
       dockerfile: ssh/Dockerfile
-      target: production 
+      target: production
     healthcheck:
       interval: 5s
       start_period: 10s
@@ -17,7 +17,7 @@ services:
     build:
       context: .
       dockerfile: api/Dockerfile
-      target: production 
+      target: production
     healthcheck:
       interval: 5s
       start_period: 10s
@@ -28,7 +28,7 @@ services:
     build:
       context: .
       dockerfile: gateway/Dockerfile
-      target: production 
+      target: production
     healthcheck:
       interval: 5s
       start_period: 10s
@@ -40,3 +40,11 @@ services:
       start_period: 10s
       retries: 20
     ports: []
+
+secrets:
+  ssh_private_key:
+    file: ./tests/ssh_private_key
+  api_private_key:
+    file: ./tests/api_private_key
+  api_public_key:
+    file: ./tests/api_public_key

tests/e2e/.dockerignore

@@ -0,0 +1,9 @@
+node_modules/
+test-results/
+playwright-report/
+blob-report/
+playwright/.cache/
+*.png
+.git/
+.gitignore
+README.md

tests/e2e/.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+*.png

tests/e2e/Dockerfile

@@ -0,0 +1,15 @@
+FROM mcr.microsoft.com/playwright:v1.57.0-jammy
+
+WORKDIR /app
+
+# Copy package files
+COPY package.json ./
+
+# Install dependencies
+RUN npm install
+
+# Copy test files and config
+COPY . .
+
+# Default command runs tests
+CMD ["npm", "test"]

tests/e2e/e2e_test.go

@@ -0,0 +1,93 @@
+package e2e
+
+import (
+	"context"
+	"io"
+	"path/filepath"
+	"strings"
+	"testing"
+	"time"
+
+	"github.com/docker/docker/api/types/container"
+	"github.com/docker/docker/api/types/mount"
+	"github.com/shellhub-io/shellhub/tests/environment"
+	"github.com/stretchr/testify/require"
+	tc "github.com/testcontainers/testcontainers-go"
+	"github.com/testcontainers/testcontainers-go/wait"
+)
+
+func TestE2E(t *testing.T) {
+	ctx := context.Background()
+
+	// Start ShellHub environment with UI (using e2e compose)
+	compose := environment.NewE2E(t).Up(ctx)
+	t.Cleanup(compose.Down)
+
+	// Get the base URL for Playwright - use gateway hostname inside Docker network
+	baseURL := "http://gateway:80"
+
+	// Run Playwright tests in container
+	t.Run("homepage", func(t *testing.T) {
+		runPlaywrightTest(t, ctx, compose, baseURL, "tests/homepage.spec.ts")
+	})
+}
+
+func runPlaywrightTest(t *testing.T, ctx context.Context, compose *environment.DockerCompose, baseURL, testFile string) {
+	// Get absolute path to e2e directory
+	absPath, err := filepath.Abs(".")
+	require.NoError(t, err)
+
+	// Get the ShellHub network name from compose environment
+	networkName := compose.Env("SHELLHUB_NETWORK")
+
+	// Create Playwright container that installs deps and runs tests
+	req := tc.ContainerRequest{
+		Image: "mcr.microsoft.com/playwright:v1.57.0-jammy",
+		Cmd: []string{
+			"sh", "-c",
+			"npm install && npx playwright test " + testFile,
+		},
+		Env: map[string]string{
+			"BASE_URL": baseURL,
+		},
+		HostConfigModifier: func(hc *container.HostConfig) {
+			hc.Mounts = []mount.Mount{
+				{
+					Type:   mount.TypeBind,
+					Source: absPath,
+					Target: "/app",
+				},
+			}
+		},
+		WorkingDir: "/app",
+		Networks:   []string{networkName},
+		WaitingFor: wait.ForExit().WithExitTimeout(5 * time.Minute),
+	}
+
+	container, err := tc.GenericContainer(ctx, tc.GenericContainerRequest{
+		ContainerRequest: req,
+		Started:          true,
+	})
+	require.NoError(t, err)
+
+	// Wait for completion
+	_, err = container.State(ctx)
+	require.NoError(t, err)
+
+	// Get and print logs
+	logs, err := container.Logs(ctx)
+	require.NoError(t, err)
+
+	buf := new(strings.Builder)
+	_, _ = io.Copy(buf, logs)
+	t.Logf("Playwright output:\n%s", buf.String())
+
+	// Cleanup
+	exitCode, err := container.State(ctx)
+	require.NoError(t, err)
+
+	_ = container.Terminate(ctx)
+
+	// Check exit code
+	require.Equal(t, 0, exitCode.ExitCode, "Playwright tests should pass")
+}

tests/main_test.go tests/e2e/main_test.gotests/main_test.go renamed to tests/e2e/main_test.go

@@ -1,13 +1,15 @@
-package main
+package e2e
 
 import (
+	"context"
 	"crypto/rand"
 	"crypto/rsa"
 	"crypto/x509"
 	"encoding/pem"
 	"os"
 	"testing"
 
+	"github.com/shellhub-io/shellhub/tests/environment"
 	log "github.com/sirupsen/logrus"
 )
 
@@ -80,16 +82,30 @@ func keygen() error {
 }
 
 func TestMain(m *testing.M) {
-	// INFO: Due to issue related on testcontainers-go, we are disabling Ryuk it as a temporary solution.
+	// INFO: Due to issue related on testcontainers-go, we are disabling Ryuk as a temporary solution.
+	// We implement our own cleanup mechanism in environment/cleanup.go to handle resource cleanup.
 	//
 	// https://github.com/testcontainers/testcontainers-go/issues/2445
-	os.Setenv("TESTCONTAINERS_RYUK_DISABLED", "true")
+	if environment.ShouldDisableRyuk() {
+		os.Setenv("TESTCONTAINERS_RYUK_DISABLED", "true")
+	}
+
+	// Initialize cleanup system
+	environment.InitCleanup()
 
 	if err := keygen(); err != nil {
 		log.WithError(err).Error("failed to generate the ShellHub keys")
-
 		os.Exit(1)
 	}
 
-	os.Exit(m.Run())
+	// Run tests
+	exitCode := m.Run()
+
+	// Cleanup any orphaned containers
+	ctx := context.Background()
+	if err := environment.CleanupOrphanedContainers(ctx); err != nil {
+		log.WithError(err).Warn("failed to cleanup orphaned containers")
+	}
+
+	os.Exit(exitCode)
 }