usr_unknown/pulumi-dokploy
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases 1 Wiki Activity

Resolve the plugin and SDKs from Gitea
Some checks failed
build / build (push) Has been cancelled
Details
release / plugin (push) Failing after 3m46s
Details
release / sdks (push) Has been skipped
Details

Browse Source 
PluginDownloadURL moves off github:// to a templated Gitea release URL.
Pulumi interpolates ${VERSION}, then appends
pulumi-resource-dokploy-v<version>-<os>-<arch>.tar.gz -- which is what
the GoReleaser archive template already produces. Schema, bridge
metadata and all four SDKs regenerated to carry it.

Releases publish to this instance's npm, PyPI, NuGet and Go registries
using the GITEA_TOKEN that Gitea injects, so no secrets need
configuring.

The Go SDK keeps its github.com module path, which is exactly why it
goes to Gitea's Go registry: pointing GOPROXY there is what makes that
path resolve at all. Verified locally by serving the module zip from a
file proxy and building a consumer against it -- note zip -D, without
which go get rejects the archive's directory entries.
This commit is contained in:
Max Vojtkov
2026-08-09 12:37:19 +03:00
parent c06d3386a6
commit a44ebd4432
40 changed files with 452 additions and 228 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
.github/workflows/build.yml → .gitea/workflows/build.yml
View File

@@ -4,7 +4,6 @@ on:
push:
branches: [main]
pull_request:
branches: [main]
workflow_dispatch: {}
env:
@@ -12,9 +11,9 @@ env:
NODE_VERSION: "20.x"
PYTHON_VERSION: "3.11"
DOTNET_VERSION: "8.0.x"
# The provider's go.mod carries a local `replace` for the upstream Terraform
# provider/go.mod carries a local `replace` for the upstream Terraform
# provider, so it has to sit next to this checkout under this exact name.
UPSTREAM_REPO: maxvojtkov/terraform-provider-dokploy
UPSTREAM_REPO: usr_unknown/terraform-provider-dokploy
UPSTREAM_DIR: dokploy-teraform
jobs:
@@ -31,6 +30,7 @@ jobs:
with:
repository: ${{ env.UPSTREAM_REPO }}
path: ${{ env.UPSTREAM_DIR }}
token: ${{ secrets.GITEA_TOKEN }}
- uses: actions/setup-go@v5
with:
@@ -61,6 +61,9 @@ jobs:
working-directory: pulumi-dokploy
run: make provider
# schema.json and bridge-metadata.json are checked in and carry no
# version, so they only change when the mapping does. A diff here means
# someone edited resources.go without re-running `make tfgen`.
- name: Fail if the checked-in schema is stale
working-directory: pulumi-dokploy
run: git diff --exit-code -- provider/cmd/pulumi-resource-dokploy/schema.json

143
.gitea/workflows/release.yml Normal file
View File

@@ -0,0 +1,143 @@
name: release
on:
push:
tags: ["v*.*.*"]
env:
GO_VERSION: "1.25.x"
NODE_VERSION: "20.x"
PYTHON_VERSION: "3.11"
DOTNET_VERSION: "8.0.x"
UPSTREAM_REPO: usr_unknown/terraform-provider-dokploy
UPSTREAM_DIR: dokploy-teraform
# Everything below authenticates with the token Gitea injects into every
# run, so releasing needs no configured secrets at all.
GITEA_HOST: gitea.coolify.vojtkov.dev
GITEA_OWNER: usr_unknown
jobs:
# The plugin binaries. Pulumi resolves them from this release via the
# PluginDownloadURL baked into the schema, so this has to land before anyone
# installs an SDK.
plugin:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
path: pulumi-dokploy
fetch-depth: 0
- uses: actions/checkout@v4
with:
repository: ${{ env.UPSTREAM_REPO }}
path: ${{ env.UPSTREAM_DIR }}
token: ${{ secrets.GITEA_TOKEN }}
- uses: actions/setup-go@v5
with:
go-version: ${{ env.GO_VERSION }}
- uses: goreleaser/goreleaser-action@v6
with:
version: latest
args: release --clean
workdir: pulumi-dokploy
env:
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
sdks:
needs: plugin
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
path: pulumi-dokploy
- uses: actions/checkout@v4
with:
repository: ${{ env.UPSTREAM_REPO }}
path: ${{ env.UPSTREAM_DIR }}
token: ${{ secrets.GITEA_TOKEN }}
- uses: actions/setup-go@v5
with:
go-version: ${{ env.GO_VERSION }}
- uses: actions/setup-node@v4
with:
node-version: ${{ env.NODE_VERSION }}
- uses: actions/setup-python@v5
with:
python-version: ${{ env.PYTHON_VERSION }}
- uses: actions/setup-dotnet@v4
with:
dotnet-version: ${{ env.DOTNET_VERSION }}
- name: Derive version from tag
run: echo "VERSION=${GITHUB_REF_NAME#v}" >> "$GITHUB_ENV"
- name: Build SDKs
working-directory: pulumi-dokploy
run: make build_sdks VERSION=${{ env.VERSION }}
- name: Publish to the Gitea npm registry
working-directory: pulumi-dokploy/sdk/nodejs/bin
env:
TOKEN: ${{ secrets.GITEA_TOKEN }}
run: |
cat > .npmrc <<EOF
@maxvojtkov:registry=https://${GITEA_HOST}/api/packages/${GITEA_OWNER}/npm/
//${GITEA_HOST}/api/packages/${GITEA_OWNER}/npm/:_authToken=${TOKEN}
EOF
npm publish
- name: Publish to the Gitea PyPI registry
working-directory: pulumi-dokploy/sdk/python
env:
TWINE_USERNAME: ${{ env.GITEA_OWNER }}
TWINE_PASSWORD: ${{ secrets.GITEA_TOKEN }}
run: |
python -m pip install --upgrade build twine
python -m build
python -m twine upload \
--repository-url "https://${GITEA_HOST}/api/packages/${GITEA_OWNER}/pypi" \
dist/*
- name: Publish to the Gitea NuGet registry
working-directory: pulumi-dokploy/sdk/dotnet
env:
TOKEN: ${{ secrets.GITEA_TOKEN }}
run: |
dotnet pack --configuration Release --output ./nupkg
dotnet nuget push ./nupkg/*.nupkg \
--source "https://${GITEA_HOST}/api/packages/${GITEA_OWNER}/nuget/index.json" \
--api-key "$TOKEN" --skip-duplicate
# The Go SDK's module path stays github.com/maxvojtkov/..., which no
# amount of Gitea hosting changes. Uploading it to Gitea's Go registry is
# what makes that path resolvable anyway: consumers point GOPROXY here.
#
# A module zip must have every entry prefixed `<module>@<version>/` and
# must contain no directory entries at all -- hence `zip -D`, without
# which `go get` fails with "has unexpected file".
- name: Publish the Go SDK to the Gitea Go registry
working-directory: pulumi-dokploy
env:
TOKEN: ${{ secrets.GITEA_TOKEN }}
run: |
set -euo pipefail
MODULE=github.com/maxvojtkov/pulumi-dokploy/sdk
STAGE="$(mktemp -d)"
DEST="$STAGE/$MODULE@v${VERSION}"
mkdir -p "$DEST"
cp sdk/go.mod sdk/go.sum "$DEST/"
cp -R sdk/go "$DEST/"
(cd "$STAGE" && zip -qrD "$STAGE/sdk.zip" . -x 'sdk.zip')
curl -fsSL -X PUT \
--user "${GITEA_OWNER}:${TOKEN}" \
--upload-file "$STAGE/sdk.zip" \
"https://${GITEA_HOST}/api/packages/${GITEA_OWNER}/go/upload"
echo "Published $MODULE@v${VERSION}"

121
.github/workflows/release.yml vendored
View File

@@ -1,121 +0,0 @@
name: release
on:
push:
tags:
- "v*.*.*"
permissions:
contents: write
env:
GO_VERSION: "1.25.x"
NODE_VERSION: "20.x"
PYTHON_VERSION: "3.11"
DOTNET_VERSION: "8.0.x"
UPSTREAM_REPO: maxvojtkov/terraform-provider-dokploy
UPSTREAM_DIR: dokploy-teraform
jobs:
# Publishes the plugin binaries. Pulumi resolves them from this release via
# the provider's `github://api.github.com/maxvojtkov/pulumi-dokploy` URL.
plugin:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
path: pulumi-dokploy
fetch-depth: 0
- uses: actions/checkout@v4
with:
repository: ${{ env.UPSTREAM_REPO }}
path: ${{ env.UPSTREAM_DIR }}
- uses: actions/setup-go@v5
with:
go-version: ${{ env.GO_VERSION }}
- uses: goreleaser/goreleaser-action@v6
with:
version: latest
args: release --clean
workdir: pulumi-dokploy
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
sdks:
needs: plugin
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
path: pulumi-dokploy
- uses: actions/checkout@v4
with:
repository: ${{ env.UPSTREAM_REPO }}
path: ${{ env.UPSTREAM_DIR }}
- uses: actions/setup-go@v5
with:
go-version: ${{ env.GO_VERSION }}
- uses: actions/setup-node@v4
with:
node-version: ${{ env.NODE_VERSION }}
registry-url: https://registry.npmjs.org
- uses: actions/setup-python@v5
with:
python-version: ${{ env.PYTHON_VERSION }}
- uses: actions/setup-dotnet@v4
with:
dotnet-version: ${{ env.DOTNET_VERSION }}
- name: Derive version from tag
run: echo "VERSION=${GITHUB_REF_NAME#v}" >> "$GITHUB_ENV"
- name: Build SDKs
working-directory: pulumi-dokploy
run: make build_sdks VERSION=${{ env.VERSION }}
- name: Publish to npm
working-directory: pulumi-dokploy/sdk/nodejs/bin
run: npm publish --access public
env:
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
- name: Publish to PyPI
working-directory: pulumi-dokploy/sdk/python
run: |
python -m pip install --upgrade build twine
python -m build
python -m twine upload dist/*
env:
TWINE_USERNAME: __token__
TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
- name: Publish to NuGet
working-directory: pulumi-dokploy/sdk/dotnet
run: |
dotnet pack --configuration Release --output ./nupkg
dotnet nuget push ./nupkg/*.nupkg \
--source https://api.nuget.org/v3/index.json \
--api-key "$NUGET_PUBLISH_KEY" --skip-duplicate
env:
NUGET_PUBLISH_KEY: ${{ secrets.NUGET_PUBLISH_KEY }}
# Go modules are consumed straight from the repository, so the generated
# SDK has to be committed and tagged as `sdk/vX.Y.Z`.
- name: Commit and tag the Go SDK
working-directory: pulumi-dokploy
run: |
git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"
git add sdk provider/cmd/pulumi-resource-dokploy/schema.json \
provider/cmd/pulumi-resource-dokploy/bridge-metadata.json
git diff --cached --quiet || git commit -m "chore: SDKs for v${{ env.VERSION }}"
git tag "sdk/v${{ env.VERSION }}"
git push origin HEAD:main --tags

21
.goreleaser.yml
View File

@@ -1,7 +1,12 @@
# Builds the provider plugin for every platform Pulumi supports and publishes
# the archives to a GitHub release. The archive names must match what
# `PluginDownloadURL: github://api.github.com/maxvojtkov/pulumi-dokploy`
# expects, so do not rename them.
# the archives to a Gitea release.
#
# Pulumi fetches these itself, from the PluginDownloadURL baked into the
# schema. Given
# https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}
# it appends `pulumi-resource-dokploy-v<version>-<os>-<arch>.tar.gz`, which is
# exactly what the archive name_template below produces. Rename one and you
# must rename the other, or `pulumi up` fails with a 404 on plugin install.
version: 2
project_name: pulumi-dokploy
@@ -44,12 +49,20 @@ snapshot:
version_template: "{{ .Version }}-SNAPSHOT"
changelog:
use: github
use: git
sort: asc
filters:
exclude:
- "^docs:"
- "^chore:"
- "^test:"
gitea_urls:
api: https://gitea.coolify.vojtkov.dev/api/v1
download: https://gitea.coolify.vojtkov.dev
release:
gitea:
owner: usr_unknown
name: pulumi-dokploy
prerelease: auto

82
README.md
View File

@@ -6,7 +6,7 @@ redirects, basic auth, registries, SSH keys, certificates and backup
destinations.
This is a *bridged* provider. All of the behaviour lives in
[`terraform-provider-dokploy`](https://github.com/maxvojtkov/terraform-provider-dokploy);
[`terraform-provider-dokploy`](https://gitea.coolify.vojtkov.dev/usr_unknown/terraform-provider-dokploy);
[`pulumi-terraform-bridge`](https://github.com/pulumi/pulumi-terraform-bridge)
turns it into a Pulumi package with typed SDKs for TypeScript, Python, Go and
.NET. The two providers stay in lockstep — a resource added upstream shows up
@@ -57,23 +57,52 @@ new dokploy.Domain("api", {
## Installing
The SDKs are published per language; the plugin binary is resolved
automatically from this repository's GitHub releases.
The SDKs live in this Gitea instance's package registries, and the plugin
binary is resolved automatically from this repository's Gitea releases — the
download URL is baked into the schema, so `pulumi up` fetches it without any
configuration.
The SDKs do need one-time registry configuration, because none of these
package managers know about a private host by default.
**TypeScript / JavaScript**
```bash
# TypeScript / JavaScript
npm config set @maxvojtkov:registry \
https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/npm/
npm install @maxvojtkov/pulumi-dokploy
```
# Python
pip install pulumi_dokploy
**Python**
# Go
go get github.com/maxvojtkov/pulumi-dokploy/sdk/go/dokploy
```bash
pip install pulumi_dokploy \
--index-url https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/pypi/simple
```
# .NET
**.NET**
```bash
dotnet nuget add source \
https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/nuget/index.json \
--name gitea-dokploy
dotnet add package Maxvojtkov.Dokploy
```
**Go** — the module path stays `github.com/maxvojtkov/...` even though nothing
is hosted on GitHub, so point the proxy at Gitea and skip the public checksum
database for that path:
```bash
export GOPROXY=https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/go,direct
export GONOSUMDB='github.com/maxvojtkov/*'
go get github.com/maxvojtkov/pulumi-dokploy/sdk/go/dokploy
```
If the registries are private, add credentials the usual way for each tool —
an `_authToken` in `.npmrc`, `--extra-index-url` with basic auth for pip, and
`--username`/`--password` on the `dotnet nuget add source`.
Before the first release, build and install it locally instead:
```bash
@@ -130,7 +159,7 @@ Like the Terraform provider, this one manages *configuration*, not *rollouts*.
Creating an `Application` writes its definition; it does not build or start
anything.
[`dokploy-deploy-action`](https://github.com/maxvojtkov/dokploy-deploy-action)
[`dokploy-deploy-action`](https://gitea.coolify.vojtkov.dev/usr_unknown/dokploy-deploy-action)
covers the other half on GitHub Actions and Gitea Actions: it triggers a
deployment, waits for the build, and fails the job when the deployment fails.
Export the application id from your stack and hand it over.
@@ -140,7 +169,7 @@ export const apiApplicationId = api.id;
```
```yaml
- uses: maxvojtkov/dokploy-deploy-action@v1
- uses: https://gitea.coolify.vojtkov.dev/usr_unknown/dokploy-deploy-action@v1
with:
host: ${{ secrets.DOKPLOY_HOST }}
api-key: ${{ secrets.DOKPLOY_API_KEY }}
@@ -163,7 +192,7 @@ Pulumi conventions applied on top:
instead — see [`examples/typescript/webService.ts`](examples/typescript/webService.ts),
which is a port of that module.
The [known API quirks](https://github.com/maxvojtkov/terraform-provider-dokploy#known-api-quirks)
The [known API quirks](https://gitea.coolify.vojtkov.dev/usr_unknown/terraform-provider-dokploy#known-api-quirks)
documented upstream apply here unchanged, because it is the same code doing the
work.
@@ -200,11 +229,16 @@ replace github.com/maxvojtkov/terraform-provider-dokploy => ../../dokploy-terafo
```
so the two repositories can be developed side by side. CI reproduces that
layout by checking the upstream provider out as a sibling directory. Once
`terraform-provider-dokploy` is tagged on GitHub, drop the `replace` and pin a
real version instead:
layout by checking the upstream provider out as a sibling directory.
The `replace` is load-bearing here, not just a convenience: the module path
says `github.com`, but the code lives on Gitea, and Go has no way to discover
that on its own. It can go away once the upstream provider is published to
Gitea's Go registry, at which point the module resolves through `GOPROXY`:
```bash
export GOPROXY=https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/go,direct
export GONOSUMDB='github.com/maxvojtkov/*'
cd provider && go mod edit -dropreplace github.com/maxvojtkov/terraform-provider-dokploy \
&& go get github.com/maxvojtkov/terraform-provider-dokploy@v0.1.0
```
@@ -221,10 +255,20 @@ Tag the repository and the `release` workflow does the rest:
git tag v0.1.0 && git push origin v0.1.0
```
It publishes plugin binaries to a GitHub release via GoReleaser, pushes the
npm / PyPI / NuGet packages, and commits and tags the Go SDK as `sdk/v0.1.0`.
The workflow needs three repository secrets: `NPM_TOKEN`, `PYPI_API_TOKEN` and
`NUGET_PUBLISH_KEY`.
GoReleaser publishes the plugin binaries to a Gitea release first — Pulumi
resolves the plugin from there, so it has to exist before anyone installs an
SDK — and then the four SDKs go to this instance's npm, PyPI, NuGet and Go
registries.
**No secrets to configure.** Every step authenticates with `secrets.GITEA_TOKEN`,
which Gitea injects into each run automatically.
Two things the workflow depends on:
- A registered `act_runner` with an `ubuntu-latest` label, and enough of a
toolchain for Go, Node, Python and .NET.
- The upstream `terraform-provider-dokploy` repository being readable by that
token, since the `replace` directive needs it checked out as a sibling.
## License

10
provider/cmd/pulumi-resource-dokploy/schema.json
View File

@@ -11,11 +11,11 @@
"category/cloud",
"category/infrastructure"
],
"homepage": "https://github.com/maxvojtkov/pulumi-dokploy",
"homepage": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy",
"license": "MPL-2.0",
"attribution": "This Pulumi package is based on the [`dokploy` Terraform Provider](https://github.com/maxvojtkov/terraform-provider-dokploy).",
"repository": "https://github.com/maxvojtkov/pulumi-dokploy",
"pluginDownloadURL": "github://api.github.com/maxvojtkov/pulumi-dokploy",
"repository": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy",
"pluginDownloadURL": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
"publisher": "maxvojtkov",
"meta": {
"moduleFormat": "(.*)(?:/[^/]*)"
@@ -38,7 +38,7 @@
"nodejs": {
"packageName": "@maxvojtkov/pulumi-dokploy",
"packageDescription": "A Pulumi package for creating and managing Dokploy resources. Based on terraform-provider-dokploy: version v0.1.0",
"readme": "\u003e This provider is a derived work of the [Terraform Provider](https://github.com/maxvojtkov/terraform-provider-dokploy)\n\u003e distributed under [MPL 2.0](https://www.mozilla.org/en-US/MPL/2.0/). If you encounter a bug or missing feature,\n\u003e first check the [`pulumi-dokploy` repo](https://github.com/maxvojtkov/pulumi-dokploy/issues); however, if that doesn't turn up anything,\n\u003e please consult the source [`terraform-provider-dokploy` repo](https://github.com/maxvojtkov/terraform-provider-dokploy/issues).",
"readme": "\u003e This provider is a derived work of the [Terraform Provider](https://github.com/maxvojtkov/terraform-provider-dokploy)\n\u003e distributed under [MPL 2.0](https://www.mozilla.org/en-US/MPL/2.0/). If you encounter a bug or missing feature,\n\u003e first check the [`pulumi-dokploy` repo](https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/issues); however, if that doesn't turn up anything,\n\u003e please consult the source [`terraform-provider-dokploy` repo](https://github.com/maxvojtkov/terraform-provider-dokploy/issues).",
"dependencies": {
"@pulumi/pulumi": "^3.0.0"
},
@@ -55,7 +55,7 @@
"requires": {
"pulumi": "\u003e=3.0.0,\u003c4.0.0"
},
"readme": "\u003e This provider is a derived work of the [Terraform Provider](https://github.com/maxvojtkov/terraform-provider-dokploy)\n\u003e distributed under [MPL 2.0](https://www.mozilla.org/en-US/MPL/2.0/). If you encounter a bug or missing feature,\n\u003e first check the [`pulumi-dokploy` repo](https://github.com/maxvojtkov/pulumi-dokploy/issues); however, if that doesn't turn up anything,\n\u003e please consult the source [`terraform-provider-dokploy` repo](https://github.com/maxvojtkov/terraform-provider-dokploy/issues).",
"readme": "\u003e This provider is a derived work of the [Terraform Provider](https://github.com/maxvojtkov/terraform-provider-dokploy)\n\u003e distributed under [MPL 2.0](https://www.mozilla.org/en-US/MPL/2.0/). If you encounter a bug or missing feature,\n\u003e first check the [`pulumi-dokploy` repo](https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/issues); however, if that doesn't turn up anything,\n\u003e please consult the source [`terraform-provider-dokploy` repo](https://github.com/maxvojtkov/terraform-provider-dokploy/issues).",
"compatibility": "tfbridge20",
"respectSchemaVersion": true,
"pyproject": {

14
provider/resources.go
View File

@@ -51,14 +51,18 @@ func Provider(version string) tfbridge.ProviderInfo {
"category/cloud", "category/infrastructure",
},
License: "MPL-2.0",
Homepage: "https://github.com/maxvojtkov/pulumi-dokploy",
Repository: "https://github.com/maxvojtkov/pulumi-dokploy",
Homepage: "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy",
Repository: "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy",
GitHubOrg: "maxvojtkov",
Version: version,
// This is not a Pulumi-published provider, so the plugin binary is
// resolved from GitHub releases rather than the Pulumi CDN.
PluginDownloadURL: "github://api.github.com/maxvojtkov/pulumi-dokploy",
// This is not a Pulumi-published provider, so the plugin binary comes
// from this repository's Gitea releases rather than the Pulumi CDN.
// Pulumi interpolates ${VERSION}, trims the trailing slash, then
// appends pulumi-resource-dokploy-v<version>-<os>-<arch>.tar.gz -- so
// this has to stay in step with the archive name_template in
// .goreleaser.yml.
PluginDownloadURL: "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
TFProviderVersion: version,
MetadataInfo: tfbridge.NewProviderMetadata(bridgeMetadata),

2
sdk/dotnet/Application.cs generated
View File

@@ -612,7 +612,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"buildSecrets",

2
sdk/dotnet/Certificate.cs generated
View File

@@ -72,7 +72,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"privateKey",

2
sdk/dotnet/Compose.cs generated
View File

@@ -300,7 +300,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
};
var merged = CustomResourceOptions.Merge(defaultOptions, options);
// Override the ID if one was specified for consistency with other language SDKs.

2
sdk/dotnet/Destination.cs generated
View File

@@ -96,7 +96,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"secretAccessKey",

2
sdk/dotnet/Domain.cs generated
View File

@@ -138,7 +138,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
};
var merged = CustomResourceOptions.Merge(defaultOptions, options);
// Override the ID if one was specified for consistency with other language SDKs.

2
sdk/dotnet/Environment.cs generated
View File

@@ -72,7 +72,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
};
var merged = CustomResourceOptions.Merge(defaultOptions, options);
// Override the ID if one was specified for consistency with other language SDKs.

2
sdk/dotnet/MariaDb.cs generated
View File

@@ -240,7 +240,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"databasePassword",

4
sdk/dotnet/Maxvojtkov.Dokploy.csproj generated
View File

@@ -6,8 +6,8 @@
<Company>maxvojtkov</Company>
<Description>A Pulumi package for creating and managing Dokploy resources</Description>
<PackageLicenseExpression>MPL-2.0</PackageLicenseExpression>
<PackageProjectUrl>https://github.com/maxvojtkov/pulumi-dokploy</PackageProjectUrl>
<RepositoryUrl>https://github.com/maxvojtkov/pulumi-dokploy</RepositoryUrl>
<PackageProjectUrl>https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy</PackageProjectUrl>
<RepositoryUrl>https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy</RepositoryUrl>
<PackageIcon>logo.png</PackageIcon>
<Version>0.1.0</Version>

2
sdk/dotnet/Mongo.cs generated
View File

@@ -234,7 +234,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"databasePassword",

2
sdk/dotnet/Mount.cs generated
View File

@@ -84,7 +84,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
};
var merged = CustomResourceOptions.Merge(defaultOptions, options);
// Override the ID if one was specified for consistency with other language SDKs.

2
sdk/dotnet/MySql.cs generated
View File

@@ -240,7 +240,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"databasePassword",

2
sdk/dotnet/Port.cs generated
View File

@@ -66,7 +66,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
};
var merged = CustomResourceOptions.Merge(defaultOptions, options);
// Override the ID if one was specified for consistency with other language SDKs.

2
sdk/dotnet/Postgres.cs generated
View File

@@ -234,7 +234,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"databasePassword",

2
sdk/dotnet/Project.cs generated
View File

@@ -72,7 +72,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
};
var merged = CustomResourceOptions.Merge(defaultOptions, options);
// Override the ID if one was specified for consistency with other language SDKs.

2
sdk/dotnet/Provider.cs generated
View File

@@ -49,7 +49,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"apiKey",

103
sdk/dotnet/README.md generated
View File

@@ -6,7 +6,7 @@ redirects, basic auth, registries, SSH keys, certificates and backup
destinations.
This is a *bridged* provider. All of the behaviour lives in
[`terraform-provider-dokploy`](https://github.com/maxvojtkov/terraform-provider-dokploy);
[`terraform-provider-dokploy`](https://gitea.coolify.vojtkov.dev/usr_unknown/terraform-provider-dokploy);
[`pulumi-terraform-bridge`](https://github.com/pulumi/pulumi-terraform-bridge)
turns it into a Pulumi package with typed SDKs for TypeScript, Python, Go and
.NET. The two providers stay in lockstep — a resource added upstream shows up
@@ -49,6 +49,7 @@ new dokploy.Domain("api", {
- [Installing](#installing)
- [Configuration](#configuration)
- [Resources and data sources](#resources-and-data-sources)
- [Deploying from CI](#deploying-from-ci)
- [Differences from the Terraform provider](#differences-from-the-terraform-provider)
- [Examples](#examples)
- [Development](#development)
@@ -56,23 +57,52 @@ new dokploy.Domain("api", {
## Installing
The SDKs are published per language; the plugin binary is resolved
automatically from this repository's GitHub releases.
The SDKs live in this Gitea instance's package registries, and the plugin
binary is resolved automatically from this repository's Gitea releases — the
download URL is baked into the schema, so `pulumi up` fetches it without any
configuration.
The SDKs do need one-time registry configuration, because none of these
package managers know about a private host by default.
**TypeScript / JavaScript**
```bash
# TypeScript / JavaScript
npm config set @maxvojtkov:registry \
https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/npm/
npm install @maxvojtkov/pulumi-dokploy
```
# Python
pip install pulumi_dokploy
**Python**
# Go
go get github.com/maxvojtkov/pulumi-dokploy/sdk/go/dokploy
```bash
pip install pulumi_dokploy \
--index-url https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/pypi/simple
```
# .NET
**.NET**
```bash
dotnet nuget add source \
https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/nuget/index.json \
--name gitea-dokploy
dotnet add package Maxvojtkov.Dokploy
```
**Go** — the module path stays `github.com/maxvojtkov/...` even though nothing
is hosted on GitHub, so point the proxy at Gitea and skip the public checksum
database for that path:
```bash
export GOPROXY=https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/go,direct
export GONOSUMDB='github.com/maxvojtkov/*'
go get github.com/maxvojtkov/pulumi-dokploy/sdk/go/dokploy
```
If the registries are private, add credentials the usual way for each tool —
an `_authToken` in `.npmrc`, `--extra-index-url` with basic auth for pip, and
`--username`/`--password` on the `dotnet nuget add source`.
Before the first release, build and install it locally instead:
```bash
@@ -123,6 +153,30 @@ pulumi config set --secret dokploy:apiKey "$DOKPLOY_API_KEY"
Data sources: `getProject`, `getProjects`, `getEnvironment`, `getApplication`,
`getServers`.
## Deploying from CI
Like the Terraform provider, this one manages *configuration*, not *rollouts*.
Creating an `Application` writes its definition; it does not build or start
anything.
[`dokploy-deploy-action`](https://gitea.coolify.vojtkov.dev/usr_unknown/dokploy-deploy-action)
covers the other half on GitHub Actions and Gitea Actions: it triggers a
deployment, waits for the build, and fails the job when the deployment fails.
Export the application id from your stack and hand it over.
```ts
export const apiApplicationId = api.id;
```
```yaml
- uses: https://gitea.coolify.vojtkov.dev/usr_unknown/dokploy-deploy-action@v1
with:
host: ${{ secrets.DOKPLOY_HOST }}
api-key: ${{ secrets.DOKPLOY_API_KEY }}
application-id: ${{ steps.stack.outputs.apiApplicationId }}
docker-image: ghcr.io/acme/api:${{ github.sha }}
```
## Differences from the Terraform provider
Everything is a mechanical translation of the Terraform provider, with three
@@ -138,7 +192,7 @@ Pulumi conventions applied on top:
instead — see [`examples/typescript/webService.ts`](examples/typescript/webService.ts),
which is a port of that module.
The [known API quirks](https://github.com/maxvojtkov/terraform-provider-dokploy#known-api-quirks)
The [known API quirks](https://gitea.coolify.vojtkov.dev/usr_unknown/terraform-provider-dokploy#known-api-quirks)
documented upstream apply here unchanged, because it is the same code doing the
work.
@@ -175,11 +229,16 @@ replace github.com/maxvojtkov/terraform-provider-dokploy => ../../dokploy-terafo
```
so the two repositories can be developed side by side. CI reproduces that
layout by checking the upstream provider out as a sibling directory. Once
`terraform-provider-dokploy` is tagged on GitHub, drop the `replace` and pin a
real version instead:
layout by checking the upstream provider out as a sibling directory.
The `replace` is load-bearing here, not just a convenience: the module path
says `github.com`, but the code lives on Gitea, and Go has no way to discover
that on its own. It can go away once the upstream provider is published to
Gitea's Go registry, at which point the module resolves through `GOPROXY`:
```bash
export GOPROXY=https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/go,direct
export GONOSUMDB='github.com/maxvojtkov/*'
cd provider && go mod edit -dropreplace github.com/maxvojtkov/terraform-provider-dokploy \
&& go get github.com/maxvojtkov/terraform-provider-dokploy@v0.1.0
```
@@ -196,10 +255,20 @@ Tag the repository and the `release` workflow does the rest:
git tag v0.1.0 && git push origin v0.1.0
```
It publishes plugin binaries to a GitHub release via GoReleaser, pushes the
npm / PyPI / NuGet packages, and commits and tags the Go SDK as `sdk/v0.1.0`.
The workflow needs three repository secrets: `NPM_TOKEN`, `PYPI_API_TOKEN` and
`NUGET_PUBLISH_KEY`.
GoReleaser publishes the plugin binaries to a Gitea release first — Pulumi
resolves the plugin from there, so it has to exist before anyone installs an
SDK — and then the four SDKs go to this instance's npm, PyPI, NuGet and Go
registries.
**No secrets to configure.** Every step authenticates with `secrets.GITEA_TOKEN`,
which Gitea injects into each run automatically.
Two things the workflow depends on:
- A registered `act_runner` with an `ubuntu-latest` label, and enough of a
toolchain for Go, Node, Python and .NET.
- The upstream `terraform-provider-dokploy` repository being readable by that
token, since the `replace` directive needs it checked out as a sibling.
## License

2
sdk/dotnet/Redirect.cs generated
View File

@@ -66,7 +66,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
};
var merged = CustomResourceOptions.Merge(defaultOptions, options);
// Override the ID if one was specified for consistency with other language SDKs.

2
sdk/dotnet/Redis.cs generated
View File

@@ -222,7 +222,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"databasePassword",

2
sdk/dotnet/Registry.cs generated
View File

@@ -84,7 +84,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"password",

2
sdk/dotnet/Security.cs generated
View File

@@ -60,7 +60,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"password",

2
sdk/dotnet/SshKey.cs generated
View File

@@ -72,7 +72,7 @@ namespace Maxvojtkov.Dokploy
var defaultOptions = new CustomResourceOptions
{
Version = Utilities.Version,
PluginDownloadURL = "github://api.github.com/maxvojtkov/pulumi-dokploy",
PluginDownloadURL = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}",
AdditionalSecretOutputs =
{
"privateKey",

4
sdk/dotnet/Utilities.cs generated
View File

@@ -53,7 +53,7 @@ namespace Maxvojtkov.Dokploy
{
var dst = src ?? new global::Pulumi.InvokeOptions{};
dst.Version = src?.Version ?? Version;
dst.PluginDownloadURL = src?.PluginDownloadURL ?? "github://api.github.com/maxvojtkov/pulumi-dokploy";
dst.PluginDownloadURL = src?.PluginDownloadURL ?? "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}";
return dst;
}
@@ -61,7 +61,7 @@ namespace Maxvojtkov.Dokploy
{
var dst = src ?? new global::Pulumi.InvokeOutputOptions{};
dst.Version = src?.Version ?? Version;
dst.PluginDownloadURL = src?.PluginDownloadURL ?? "github://api.github.com/maxvojtkov/pulumi-dokploy";
dst.PluginDownloadURL = src?.PluginDownloadURL ?? "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}";
return dst;
}

2
sdk/dotnet/pulumi-plugin.json generated
View File

@@ -2,5 +2,5 @@
"resource": true,
"name": "dokploy",
"version": "0.1.0",
"server": "github://api.github.com/maxvojtkov/pulumi-dokploy"
"server": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}"
}

4
sdk/go/dokploy/internal/pulumiUtilities.go generated
View File

@@ -164,7 +164,7 @@ func callPlainInner(
// PkgResourceDefaultOpts provides package level defaults to pulumi.OptionResource.
func PkgResourceDefaultOpts(opts []pulumi.ResourceOption) []pulumi.ResourceOption {
defaults := []pulumi.ResourceOption{}
defaults = append(defaults, pulumi.PluginDownloadURL("github://api.github.com/maxvojtkov/pulumi-dokploy"))
defaults = append(defaults, pulumi.PluginDownloadURL("https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}"))
version := semver.MustParse("0.1.0")
if !version.Equals(semver.Version{}) {
defaults = append(defaults, pulumi.Version(version.String()))
@@ -175,7 +175,7 @@ func PkgResourceDefaultOpts(opts []pulumi.ResourceOption) []pulumi.ResourceOptio
// PkgInvokeDefaultOpts provides package level defaults to pulumi.OptionInvoke.
func PkgInvokeDefaultOpts(opts []pulumi.InvokeOption) []pulumi.InvokeOption {
defaults := []pulumi.InvokeOption{}
defaults = append(defaults, pulumi.PluginDownloadURL("github://api.github.com/maxvojtkov/pulumi-dokploy"))
defaults = append(defaults, pulumi.PluginDownloadURL("https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}"))
version := semver.MustParse("0.1.0")
if !version.Equals(semver.Version{}) {
defaults = append(defaults, pulumi.Version(version.String()))

2
sdk/go/dokploy/pulumi-plugin.json generated
View File

@@ -2,5 +2,5 @@
"resource": true,
"name": "dokploy",
"version": "0.1.0",
"server": "github://api.github.com/maxvojtkov/pulumi-dokploy"
"server": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}"
}

2
sdk/nodejs/README.md generated
View File

@@ -1,4 +1,4 @@
> This provider is a derived work of the [Terraform Provider](https://github.com/maxvojtkov/terraform-provider-dokploy)
> distributed under [MPL 2.0](https://www.mozilla.org/en-US/MPL/2.0/). If you encounter a bug or missing feature,
> first check the [`pulumi-dokploy` repo](https://github.com/maxvojtkov/pulumi-dokploy/issues); however, if that doesn't turn up anything,
> first check the [`pulumi-dokploy` repo](https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/issues); however, if that doesn't turn up anything,
> please consult the source [`terraform-provider-dokploy` repo](https://github.com/maxvojtkov/terraform-provider-dokploy/issues).

6
sdk/nodejs/package.json generated
View File

@@ -11,8 +11,8 @@
"category/cloud",
"category/infrastructure"
],
"homepage": "https://github.com/maxvojtkov/pulumi-dokploy",
"repository": "https://github.com/maxvojtkov/pulumi-dokploy",
"homepage": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy",
"repository": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy",
"license": "MPL-2.0",
"scripts": {
"build": "tsc"
@@ -28,6 +28,6 @@
"resource": true,
"name": "dokploy",
"version": "0.1.0",
"server": "github://api.github.com/maxvojtkov/pulumi-dokploy"
"server": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}"
}
}

2
sdk/nodejs/utilities.ts generated
View File

@@ -53,7 +53,7 @@ export function getVersion(): string {
/** @internal */
export function resourceOptsDefaults(): any {
return { version: getVersion(), pluginDownloadURL: "github://api.github.com/maxvojtkov/pulumi-dokploy" };
return { version: getVersion(), pluginDownloadURL: "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}" };
}
/** @internal */

103
sdk/python/README.md generated
View File

@@ -6,7 +6,7 @@ redirects, basic auth, registries, SSH keys, certificates and backup
destinations.
This is a *bridged* provider. All of the behaviour lives in
[`terraform-provider-dokploy`](https://github.com/maxvojtkov/terraform-provider-dokploy);
[`terraform-provider-dokploy`](https://gitea.coolify.vojtkov.dev/usr_unknown/terraform-provider-dokploy);
[`pulumi-terraform-bridge`](https://github.com/pulumi/pulumi-terraform-bridge)
turns it into a Pulumi package with typed SDKs for TypeScript, Python, Go and
.NET. The two providers stay in lockstep — a resource added upstream shows up
@@ -49,6 +49,7 @@ new dokploy.Domain("api", {
- [Installing](#installing)
- [Configuration](#configuration)
- [Resources and data sources](#resources-and-data-sources)
- [Deploying from CI](#deploying-from-ci)
- [Differences from the Terraform provider](#differences-from-the-terraform-provider)
- [Examples](#examples)
- [Development](#development)
@@ -56,23 +57,52 @@ new dokploy.Domain("api", {
## Installing
The SDKs are published per language; the plugin binary is resolved
automatically from this repository's GitHub releases.
The SDKs live in this Gitea instance's package registries, and the plugin
binary is resolved automatically from this repository's Gitea releases — the
download URL is baked into the schema, so `pulumi up` fetches it without any
configuration.
The SDKs do need one-time registry configuration, because none of these
package managers know about a private host by default.
**TypeScript / JavaScript**
```bash
# TypeScript / JavaScript
npm config set @maxvojtkov:registry \
https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/npm/
npm install @maxvojtkov/pulumi-dokploy
```
# Python
pip install pulumi_dokploy
**Python**
# Go
go get github.com/maxvojtkov/pulumi-dokploy/sdk/go/dokploy
```bash
pip install pulumi_dokploy \
--index-url https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/pypi/simple
```
# .NET
**.NET**
```bash
dotnet nuget add source \
https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/nuget/index.json \
--name gitea-dokploy
dotnet add package Maxvojtkov.Dokploy
```
**Go** — the module path stays `github.com/maxvojtkov/...` even though nothing
is hosted on GitHub, so point the proxy at Gitea and skip the public checksum
database for that path:
```bash
export GOPROXY=https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/go,direct
export GONOSUMDB='github.com/maxvojtkov/*'
go get github.com/maxvojtkov/pulumi-dokploy/sdk/go/dokploy
```
If the registries are private, add credentials the usual way for each tool —
an `_authToken` in `.npmrc`, `--extra-index-url` with basic auth for pip, and
`--username`/`--password` on the `dotnet nuget add source`.
Before the first release, build and install it locally instead:
```bash
@@ -123,6 +153,30 @@ pulumi config set --secret dokploy:apiKey "$DOKPLOY_API_KEY"
Data sources: `getProject`, `getProjects`, `getEnvironment`, `getApplication`,
`getServers`.
## Deploying from CI
Like the Terraform provider, this one manages *configuration*, not *rollouts*.
Creating an `Application` writes its definition; it does not build or start
anything.
[`dokploy-deploy-action`](https://gitea.coolify.vojtkov.dev/usr_unknown/dokploy-deploy-action)
covers the other half on GitHub Actions and Gitea Actions: it triggers a
deployment, waits for the build, and fails the job when the deployment fails.
Export the application id from your stack and hand it over.
```ts
export const apiApplicationId = api.id;
```
```yaml
- uses: https://gitea.coolify.vojtkov.dev/usr_unknown/dokploy-deploy-action@v1
with:
host: ${{ secrets.DOKPLOY_HOST }}
api-key: ${{ secrets.DOKPLOY_API_KEY }}
application-id: ${{ steps.stack.outputs.apiApplicationId }}
docker-image: ghcr.io/acme/api:${{ github.sha }}
```
## Differences from the Terraform provider
Everything is a mechanical translation of the Terraform provider, with three
@@ -138,7 +192,7 @@ Pulumi conventions applied on top:
instead — see [`examples/typescript/webService.ts`](examples/typescript/webService.ts),
which is a port of that module.
The [known API quirks](https://github.com/maxvojtkov/terraform-provider-dokploy#known-api-quirks)
The [known API quirks](https://gitea.coolify.vojtkov.dev/usr_unknown/terraform-provider-dokploy#known-api-quirks)
documented upstream apply here unchanged, because it is the same code doing the
work.
@@ -175,11 +229,16 @@ replace github.com/maxvojtkov/terraform-provider-dokploy => ../../dokploy-terafo
```
so the two repositories can be developed side by side. CI reproduces that
layout by checking the upstream provider out as a sibling directory. Once
`terraform-provider-dokploy` is tagged on GitHub, drop the `replace` and pin a
real version instead:
layout by checking the upstream provider out as a sibling directory.
The `replace` is load-bearing here, not just a convenience: the module path
says `github.com`, but the code lives on Gitea, and Go has no way to discover
that on its own. It can go away once the upstream provider is published to
Gitea's Go registry, at which point the module resolves through `GOPROXY`:
```bash
export GOPROXY=https://gitea.coolify.vojtkov.dev/api/packages/usr_unknown/go,direct
export GONOSUMDB='github.com/maxvojtkov/*'
cd provider && go mod edit -dropreplace github.com/maxvojtkov/terraform-provider-dokploy \
&& go get github.com/maxvojtkov/terraform-provider-dokploy@v0.1.0
```
@@ -196,10 +255,20 @@ Tag the repository and the `release` workflow does the rest:
git tag v0.1.0 && git push origin v0.1.0
```
It publishes plugin binaries to a GitHub release via GoReleaser, pushes the
npm / PyPI / NuGet packages, and commits and tags the Go SDK as `sdk/v0.1.0`.
The workflow needs three repository secrets: `NPM_TOKEN`, `PYPI_API_TOKEN` and
`NUGET_PUBLISH_KEY`.
GoReleaser publishes the plugin binaries to a Gitea release first — Pulumi
resolves the plugin from there, so it has to exist before anyone installs an
SDK — and then the four SDKs go to this instance's npm, PyPI, NuGet and Go
registries.
**No secrets to configure.** Every step authenticates with `secrets.GITEA_TOKEN`,
which Gitea injects into each run automatically.
Two things the workflow depends on:
- A registered `act_runner` with an `ubuntu-latest` label, and enough of a
toolchain for Go, Node, Python and .NET.
- The upstream `terraform-provider-dokploy` repository being readable by that
token, since the `replace` directive needs it checked out as a sibling.
## License

2
sdk/python/pulumi_dokploy/README.md generated
View File

@@ -1,4 +1,4 @@
> This provider is a derived work of the [Terraform Provider](https://github.com/maxvojtkov/terraform-provider-dokploy)
> distributed under [MPL 2.0](https://www.mozilla.org/en-US/MPL/2.0/). If you encounter a bug or missing feature,
> first check the [`pulumi-dokploy` repo](https://github.com/maxvojtkov/pulumi-dokploy/issues); however, if that doesn't turn up anything,
> first check the [`pulumi-dokploy` repo](https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/issues); however, if that doesn't turn up anything,
> please consult the source [`terraform-provider-dokploy` repo](https://github.com/maxvojtkov/terraform-provider-dokploy/issues).

2
sdk/python/pulumi_dokploy/_utilities.py generated
View File

@@ -322,7 +322,7 @@ def deprecated(message: str) -> typing.Callable[[C], C]:
return decorator
def get_plugin_download_url():
return "github://api.github.com/maxvojtkov/pulumi-dokploy"
return "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}"
def get_version():
return _version_str

2
sdk/python/pulumi_dokploy/pulumi-plugin.json generated
View File

@@ -2,5 +2,5 @@
"resource": true,
"name": "dokploy",
"version": "0.1.0",
"server": "github://api.github.com/maxvojtkov/pulumi-dokploy"
"server": "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy/releases/download/v${VERSION}"
}

4
sdk/python/pyproject.toml generated
View File

@@ -9,8 +9,8 @@
[project.license]
text = "MPL-2.0"
[project.urls]
Homepage = "https://github.com/maxvojtkov/pulumi-dokploy"
Repository = "https://github.com/maxvojtkov/pulumi-dokploy"
Homepage = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy"
Repository = "https://gitea.coolify.vojtkov.dev/usr_unknown/pulumi-dokploy"
[build-system]
requires = ["setuptools>=61.0"]