feat(preview): Gitea/Forgejo preview deployments (port of upstream #5149)

CONTRIBUTING.md

@@ -120,12 +120,20 @@ pnpm run docker:push
 
 ## Password Reset
 
-In the case you lost your password, you can reset it using the following command
+In the case you lost your password, you can reset the owner's password using the following command
 
 ```bash
 pnpm run reset-password
 ```
 
+To reset the password of a specific user instead, pass their email as an argument
+
+```bash
+pnpm run reset-password -- user@example.com
+```
+
+Both commands print the new randomly generated password to the console.
+
 If you want to test the webhooks on development mode using localtunnel, make sure to install [`localtunnel`](https://localtunnel.app/)
 
 ```bash

apps/api/README.md

@@ -6,3 +6,13 @@ npm run dev
 ```
 open http://localhost:3000
 ```
+
+## Inngest
+
+This service uses Inngest to queue deployments. Run the local dev server in a separate terminal:
+
+```
+npm run dev:inngest
+```
+
+It syncs with the app at `http://localhost:4000/api/inngest` and serves its dashboard at `http://localhost:8288`.

apps/api/package.json

@@ -4,6 +4,7 @@
 	"type": "module",
 	"scripts": {
 		"dev": "PORT=4000 tsx watch src/index.ts",
+		"dev:inngest": "npx --yes inngest-cli@1.9.0 dev -u http://localhost:4000/api/inngest --no-discovery",
 		"build": "rimraf dist && tsc --project tsconfig.json",
 		"start": "node dist/index.js",
 		"typecheck": "tsc --noEmit"

apps/dokploy/__test__/compose/compose-project-directory.test.ts

@@ -55,4 +55,69 @@ describe("compose createCommand --project-directory", () => {
 		);
 		expect(cmd).toContain("-f docker-compose.yml");
 	});
+
+	it("resolves build.context against the compose file's own directory when there are no mounts", () => {
+		const cmd = createCommand({
+			...base,
+			composePath: "./backend/docker-compose.yml",
+		} as any);
+
+		expect(cmd).not.toContain("--project-directory");
+		expect(cmd).toContain("-f ./backend/docker-compose.yml");
+	});
+});
+
+describe("compose createCommand --env-file", () => {
+	it("points --env-file at the generated .env next to a nested compose file", () => {
+		const cmd = createCommand(
+			{
+				...base,
+				composePath: "./deploy/docker-compose.yml",
+				createEnvFile: true,
+			} as any,
+			"/etc/dokploy/compose/compose-app/code",
+		);
+
+		expect(cmd).toContain("--env-file deploy/.env");
+		expect(cmd).toContain(
+			"--project-directory /etc/dokploy/compose/compose-app/code",
+		);
+	});
+
+	it("omits --env-file when createEnvFile is disabled", () => {
+		const cmd = createCommand(
+			{ ...base, composePath: "./deploy/docker-compose.yml" } as any,
+			"/etc/dokploy/compose/compose-app/code",
+		);
+
+		expect(cmd).not.toContain("--env-file");
+	});
+
+	it("uses the code-root .env for raw sourceType", () => {
+		const cmd = createCommand(
+			{
+				...base,
+				sourceType: "raw",
+				composePath: "docker-compose.yml",
+				createEnvFile: true,
+			} as any,
+			"/etc/dokploy/compose/compose-app/code",
+		);
+
+		expect(cmd).toContain("--env-file .env");
+	});
+
+	it("does not add --env-file to stack deploy (unsupported flag)", () => {
+		const cmd = createCommand(
+			{
+				...base,
+				composeType: "stack",
+				composePath: "./deploy/docker-compose.yml",
+				createEnvFile: true,
+			} as any,
+			"/etc/dokploy/compose/compose-app/code",
+		);
+
+		expect(cmd).not.toContain("--env-file");
+	});
 });

apps/dokploy/__test__/deploy/application.real.test.ts

@@ -73,6 +73,10 @@ vi.mock("@dokploy/server/services/deployment", () => ({
 	createDeployment: vi.fn(),
 	updateDeploymentStatus: vi.fn(),
 	updateDeployment: vi.fn(),
+	// deployApplication's catch block calls this. Without it in the mock, any
+	// real deploy failure is reported as "No getDeploymentErrorMessage export is
+	// defined on the mock" and the actual build error is lost.
+	getDeploymentErrorMessage: vi.fn().mockResolvedValue("Error building"),
 }));
 
 vi.mock("@dokploy/server/utils/notifications/build-success", () => ({
@@ -455,6 +459,14 @@ describe(
 					buildType: "dockerfile",
 					customGitBuildPath: "/deno",
 					dockerfile: "Dockerfile",
+					// Upstream v0.30.5 (f1e2467bb) changed the *default* build context
+					// from "the directory holding the Dockerfile" to the repository
+					// root, so the UI placeholder claiming the default is "." is now
+					// true. examples/deno/Dockerfile does `COPY deno.json .`, which
+					// only resolves when the context is the deno/ directory, so the
+					// context now has to be stated explicitly - exactly the migration
+					// every existing subdirectory-Dockerfile app has to make.
+					dockerContextPath: "/deno",
 				});
 				currentAppName = dockerfileAppName;
 				allTestAppNames.push(dockerfileAppName);

apps/dokploy/__test__/deploy/fixtures/gitea-pull-request-deliveries.json

@@ -0,0 +1,230 @@
+[
+	{
+		"headers": {
+			"content-type": "application/json",
+			"x-github-event": "pull_request",
+			"x-gitea-delivery": "00000000-0000-0000-0000-000000000000",
+			"x-gitea-event": "pull_request",
+			"x-gitea-event-type": "pull_request"
+		},
+		"body": {
+			"action": "opened",
+			"number": 1,
+			"repository": {
+				"name": "web",
+				"full_name": "repoowner/web",
+				"owner": {
+					"login": "repoowner"
+				}
+			},
+			"pull_request": {
+				"id": 1,
+				"number": 1,
+				"title": "Add a thing",
+				"html_url": "http://localhost:3939/repoowner/web/pulls/1",
+				"merged": false,
+				"user": {
+					"login": "writer"
+				},
+				"labels": [],
+				"base": {
+					"ref": "main"
+				},
+				"head": {
+					"ref": "feature/thing",
+					"sha": "d2253306c8cccbc2b76bbaea89092d23db7778f3",
+					"repo": {
+						"name": "web",
+						"owner": {
+							"login": "repoowner"
+						}
+					}
+				}
+			}
+		}
+	},
+	{
+		"headers": {
+			"content-type": "application/json",
+			"x-github-event": "pull_request",
+			"x-gitea-delivery": "00000000-0000-0000-0000-000000000001",
+			"x-gitea-event": "pull_request",
+			"x-gitea-event-type": "pull_request_sync"
+		},
+		"body": {
+			"action": "synchronized",
+			"number": 1,
+			"repository": {
+				"name": "web",
+				"full_name": "repoowner/web",
+				"owner": {
+					"login": "repoowner"
+				}
+			},
+			"pull_request": {
+				"id": 1,
+				"number": 1,
+				"title": "Add a thing",
+				"html_url": "http://localhost:3939/repoowner/web/pulls/1",
+				"merged": false,
+				"user": {
+					"login": "writer"
+				},
+				"labels": [],
+				"base": {
+					"ref": "main"
+				},
+				"head": {
+					"ref": "feature/thing",
+					"sha": "03ed76d4fc6b09b7e793dc009f918f47aeca45c1",
+					"repo": {
+						"name": "web",
+						"owner": {
+							"login": "repoowner"
+						}
+					}
+				}
+			}
+		}
+	},
+	{
+		"headers": {
+			"content-type": "application/json",
+			"x-github-event": "pull_request",
+			"x-gitea-delivery": "00000000-0000-0000-0000-000000000002",
+			"x-gitea-event": "pull_request",
+			"x-gitea-event-type": "pull_request_label"
+		},
+		"body": {
+			"action": "label_updated",
+			"number": 1,
+			"repository": {
+				"name": "web",
+				"full_name": "repoowner/web",
+				"owner": {
+					"login": "repoowner"
+				}
+			},
+			"pull_request": {
+				"id": 1,
+				"number": 1,
+				"title": "Add a thing",
+				"html_url": "http://localhost:3939/repoowner/web/pulls/1",
+				"merged": false,
+				"user": {
+					"login": "writer"
+				},
+				"labels": [
+					{
+						"name": "preview"
+					}
+				],
+				"base": {
+					"ref": "main"
+				},
+				"head": {
+					"ref": "feature/thing",
+					"sha": "03ed76d4fc6b09b7e793dc009f918f47aeca45c1",
+					"repo": {
+						"name": "web",
+						"owner": {
+							"login": "repoowner"
+						}
+					}
+				}
+			}
+		}
+	},
+	{
+		"headers": {
+			"content-type": "application/json",
+			"x-github-event": "pull_request",
+			"x-gitea-delivery": "00000000-0000-0000-0000-000000000003",
+			"x-gitea-event": "pull_request",
+			"x-gitea-event-type": "pull_request_label"
+		},
+		"body": {
+			"action": "label_cleared",
+			"number": 1,
+			"repository": {
+				"name": "web",
+				"full_name": "repoowner/web",
+				"owner": {
+					"login": "repoowner"
+				}
+			},
+			"pull_request": {
+				"id": 1,
+				"number": 1,
+				"title": "Add a thing",
+				"html_url": "http://localhost:3939/repoowner/web/pulls/1",
+				"merged": false,
+				"user": {
+					"login": "writer"
+				},
+				"labels": [
+					{
+						"name": "preview"
+					}
+				],
+				"base": {
+					"ref": "main"
+				},
+				"head": {
+					"ref": "feature/thing",
+					"sha": "03ed76d4fc6b09b7e793dc009f918f47aeca45c1",
+					"repo": {
+						"name": "web",
+						"owner": {
+							"login": "repoowner"
+						}
+					}
+				}
+			}
+		}
+	},
+	{
+		"headers": {
+			"content-type": "application/json",
+			"x-github-event": "issue_comment",
+			"x-gitea-delivery": "00000000-0000-0000-0000-000000000004",
+			"x-gitea-event": "issue_comment",
+			"x-gitea-event-type": "pull_request_comment"
+		},
+		"body": {
+			"action": "created",
+			"number": null,
+			"repository": {
+				"name": "web",
+				"full_name": "repoowner/web",
+				"owner": {
+					"login": "repoowner"
+				}
+			},
+			"pull_request": {
+				"id": 1,
+				"number": 1,
+				"title": "Add a thing",
+				"html_url": "http://localhost:3939/repoowner/web/pulls/1",
+				"merged": false,
+				"user": {
+					"login": "writer"
+				},
+				"labels": [],
+				"base": {
+					"ref": "main"
+				},
+				"head": {
+					"ref": "feature/thing",
+					"sha": "03ed76d4fc6b09b7e793dc009f918f47aeca45c1",
+					"repo": {
+						"name": "web",
+						"owner": {
+							"login": "repoowner"
+						}
+					}
+				}
+			}
+		}
+	}
+]