Merge pull request #12670 from appwrite/chore/1.9.5-release-updates-main

1.9.5 release updates
This commit is contained in:
Chirag Aggarwal authored and GitHub committed 2026-06-24 14:44:37 +05:30
commit 532fda5bf3
15 files changed
+289 -132

No files matched your search

+139
View File
@@ -0,0 +1,139 @@
---
name: self-hosted-release
description: Enforce Appwrite self-hosted release readiness checks. Use when validating a self-hosted RC or final release, running fresh Docker Compose install tests, testing realistic e2e workflows, discovering the previous stable release baseline, upgrading seeded data from the previous self-hosted release, verifying migrations, compatibility filters, release metadata, installer behavior, or deciding whether a self-hosted release is safe to publish.
compatibility: Requires an Appwrite server repository checkout, Docker Compose, network access to fetch tags/images, and the normal Appwrite test environment.
---
# Self-Hosted Release
## Purpose
Use this skill as a release gate for Appwrite self-hosted RCs and final releases. Do not treat container health or metadata review as enough. A release is not ready until a fresh self-hosted stack works with realistic workflows and an upgrade from the previous stable self-hosted release preserves seeded data through migrations.
## Release Context
1. Confirm the current branch and target version:
- Check the branch name, `app/init/constants.php`, release notes, Docker image tags, and the user's stated target.
- If those disagree, stop and resolve the target version before validating.
2. Determine the previous stable self-hosted baseline automatically:
- Prefer remote tags so stale local tags do not mislead the gate.
- Use stable semver tags lower than the target version; ignore RC, beta, alpha, dev, and other prerelease tags.
- Pick the highest stable version lower than the target as the upgrade and compatibility baseline.
- Only ask the user for a baseline if no stable lower tag can be discovered or the target version is ambiguous.
3. Record the target version, target commit SHA, previous stable baseline, database adapter(s), Compose profile(s), and any release-specific risks before starting validation.
Useful commands:
```sh
git rev-parse --abbrev-ref HEAD
git rev-parse HEAD
rg -n "APP_VERSION_STABLE|APP_CACHE_BUSTER" app/init/constants.php
git ls-remote --tags origin "refs/tags/*"
```
## Fresh Install Gate
Build and run the target release with the local Docker Compose stack, then test it like a real self-hosted install.
1. Start from a clean stack and build the target:
```sh
docker compose down -v
docker compose up -d --force-recreate --build --wait
docker compose exec -T appwrite vars
curl -fsS http://localhost/v1/health/version
```
2. Inspect runtime health before running tests:
- Check `docker compose ps` and `docker compose logs` for crash loops, missing env vars, failed mounts, worker failures, executor/runtime failures, migration errors, queue errors, and warnings that indicate broken self-hosted wiring.
- Verify required services are reachable through the public HTTP surface, not only from inside containers.
- If a route is advertised by specs, docs, install templates, or release notes, verify the route actually exists and returns the expected auth/validation behavior.
3. Run the Appwrite test suite inside Docker:
```sh
docker compose exec -T appwrite test /usr/src/code/tests/unit
docker compose exec -T appwrite test /usr/src/code/tests/e2e/General
docker compose exec -T appwrite sh -lc 'vendor/bin/paratest --processes "$(nproc)" /usr/src/code/tests/e2e/Services --exclude-group abuseEnabled --exclude-group screenshots'
```
When validating a risky release, broaden the matrix with the same database adapters and modes CI uses. At minimum, cover the default self-hosted adapter and every adapter touched by migrations, storage, query behavior, relationships, or installer changes.
4. Exercise realistic workflows with real-ish data:
- Create console users, projects, API keys, platforms, webhooks, teams, memberships, and sessions.
- Create databases/tables/columns/indexes/relationships and rows with varied permissions, sizes, types, pagination, filters, and updates.
- Create storage buckets and files, then read, update, preview/download, and delete them through public APIs.
- Create and execute functions/sites when compute, runtimes, builds, domains, or executor behavior changed.
- Exercise messaging, realtime, domains, auth providers, abuse/rate-limit behavior, and background workers when they are in scope.
- Use public APIs and SDK-like calls wherever practical; direct database inspection is only supporting evidence.
Block the release for any missing env var, broken container dependency, failing public route, unexpected 5xx, queue/worker failure, test failure, or workflow that only works with unrealistic empty data.
## Upgrade Gate
Validate upgrade from the previous stable self-hosted release to the target release using the same persisted volumes and configuration.
1. Install the previous stable baseline:
- Use the discovered baseline tag/image, not a hardcoded version.
- Start with the documented self-hosted install path and a clean volume set.
- Confirm `/v1/health/version` reports the baseline version.
2. Seed broad, realistic data on the baseline before upgrading:
- Include multiple projects, users, teams, memberships, API keys, sessions/tokens, databases/tables/rows, attributes, indexes, relationships, permissions, buckets, files, functions/sites, executions, webhooks, messaging/realtime resources, domains, and project settings as applicable.
- Include edge-shaped data that migrations commonly break: empty values, long strings, arrays, enums, relationships, large files, many rows, deleted/disabled resources, and mixed permissions.
- Capture enough IDs and API calls to verify the same resources after upgrade.
3. Upgrade the baseline stack to the target release:
- Reuse the same volumes and configuration.
- Replace the Appwrite image/tag with the target release build.
- Run the documented upgrade path and required migration command(s).
- Capture logs for appwrite, workers, databases, redis, executor, and proxy services during the first boot.
4. Verify migration behavior:
- Migration completes without fatal errors, partial failures, or skipped projects.
- Running the migration again is safe and idempotent.
- A failed or interrupted migration can be retried without data loss when that scenario is relevant to the changed migration.
- Existing volumes can be reused after restart.
5. Verify seeded data after upgrade through public APIs:
- Fetch and mutate seeded projects, users, teams, permissions, rows, files, functions/sites, executions, domains, webhooks, messaging/realtime resources, and settings.
- Confirm indexes, relationships, file contents, execution history, auth/session behavior, and background worker side effects still work.
- Run focused e2e tests against the upgraded stack for every service touched by migration, compatibility, installer, or public API changes.
Block the release for migration failure, non-idempotency, data loss, changed permissions, broken reads/writes on upgraded data, failed workers/queues after upgrade, or any behavior that only works on fresh installs.
## Metadata And Compatibility Gate
Review release metadata after the runtime gates, not instead of them:
- `app/init/constants.php`: `APP_VERSION_STABLE` is the target version and `APP_CACHE_BUSTER` is incremented.
- `docker-compose.yml` and `app/views/install/compose.phtml`: Appwrite and console image tags are correct for the target release.
- `README.md` and `README-CN.md`: self-hosted install snippets use the target release.
- `src/Appwrite/Migration/Migration.php`: the target version maps to the correct migration class.
- `CHANGES.md`: the target version has user-facing notes for notable changes, fixes, migrations, compatibility notes, and self-hosted operator impact.
- Generated/public outputs are refreshed when API specs, SDKs, install templates, Docker Compose output, or metadata-driven docs changed.
For public API changes, compare against the previous stable baseline:
- Look for renamed/removed fields, new required inputs, enum changes, response model changes, status-code changes, route behavior changes, permission changes, and SDK-visible serialization changes.
- Request filters live in `src/Appwrite/Utopia/Request/Filters/V*.php`.
- Response filters live in `src/Appwrite/Utopia/Response/Filters/V*.php`.
- Filters must be registered in `app/controllers/general.php` for the correct `x-appwrite-response-format` boundary.
- Every compatibility filter needs focused unit coverage under `tests/unit/Utopia/Request/Filters` or `tests/unit/Utopia/Response/Filters`.
- Add service e2e coverage with `x-appwrite-response-format` when behavior depends on routing, auth, persistence, validation, or serialization.
Block the release when a public breaking change lacks a compatibility filter and tests, unless the release owner explicitly accepts the break and documents it in release notes.
## Release Decision
Do not approve an RC or final self-hosted release until all gates pass:
- Fresh install stack builds, starts, and survives realistic workflows.
- Full relevant tests pass inside Docker.
- No missing env vars, broken mounts, failed workers, broken routes, or unexplained runtime errors remain.
- Previous stable release is installed, seeded with broad data, upgraded to the target, migrated, restarted, and verified through public APIs.
- Migrations are complete, idempotent, retryable where relevant, and preserve seeded data.
- Compatibility filters and tests cover unintended public breaking changes.
- Version constants, image tags, install snippets, migration mapping, generated outputs, and changelog are current.
For every RC/final validation, produce a short release evidence summary with: target version, commit SHA, previous stable baseline, tested database adapters and modes, fresh install scenarios, upgrade scenarios, seeded data categories, test commands and results, blockers found, fixes applied, and remaining owner-approved risks.
@@ -0,0 +1,4 @@
interface:
display_name: "Self-Hosted Release"
short_description: "Validate Appwrite self-hosted release gates"
default_prompt: "Use $self-hosted-release to validate a fresh install and upgrade path for an Appwrite self-hosted release."
+70 -75
View File
@@ -1,45 +1,40 @@
_APP_ENV=development
_APP_EDITION=self-hosted
_APP_LOCALE=en
_APP_OPENSSL_KEY_V1=your-secret-key
_APP_RULES_FORMAT=md5
_APP_SYSTEM_RESPONSE_FORMAT=
_APP_TRUSTED_HEADERS=x-forwarded-for
_APP_POOL_ADAPTER=stack
_APP_WORKER_PER_CORE=6
_APP_WORKERS_NUM=1
_APP_WORKER_MAX_COROUTINES=1
_APP_WORKER_SCREENSHOTS_ROUTER=http://appwrite
_APP_REALTIME_TAIL_RATE=50
_APP_COMPRESSION_ENABLED=enabled
_APP_COMPRESSION_MIN_SIZE_BYTES=1024
_APP_CONSOLE_WHITELIST_ROOT=disabled
_APP_CONSOLE_WHITELIST_EMAILS=
_APP_CONSOLE_SESSION_ALERTS=enabled
_APP_CONSOLE_WHITELIST_IPS=
_APP_CONSOLE_COUNTRIES_DENYLIST=AQ
_APP_CONSOLE_HOSTNAMES=localhost,appwrite.io,*.appwrite.io
_APP_CONSOLE_SCHEMA=appwriteio
_APP_MIGRATION_HOST=appwrite
_APP_SYSTEM_EMAIL_NAME=Appwrite
_APP_SYSTEM_EMAIL_ADDRESS=noreply@appwrite.io
_APP_SYSTEM_TEAM_EMAIL=team@appwrite.io
_APP_EMAIL_SECURITY=security@appwrite.io
_APP_EMAIL_CERTIFICATES=certificates@appwrite.io
_APP_SYSTEM_RESPONSE_FORMAT=
_APP_CUSTOM_DOMAIN_DENY_LIST=
_APP_OPTIONS_ABUSE=disabled
_APP_OPTIONS_ROUTER_PROTECTION=disabled
_APP_OPTIONS_FORCE_HTTPS=disabled
_APP_OPTIONS_ROUTER_FORCE_HTTPS=disabled
_APP_OPENSSL_KEY_V1=your-secret-key
_APP_DNS=172.16.238.100 # CoreDNS
_APP_DOMAIN=appwrite.test
_APP_CONSOLE_DOMAIN=localhost
_APP_CONSOLE_TRUSTED_PROJECTS=trusted-project,another-trusted-project
_APP_DOMAIN_FUNCTIONS=functions.localhost
_APP_DOMAIN_SITES=sites.localhost,rebranded.localhost
_APP_DOMAIN_TARGET_CNAME=cname.localhost
_APP_DOMAIN_TARGET_A=203.0.0.1
_APP_DOMAIN_TARGET_AAAA=::1
_APP_DOMAIN_TARGET_CAA=digicert.com
_APP_RULES_FORMAT=md5
_APP_REDIS_HOST=redis
_APP_REDIS_PORT=6379
_APP_REDIS_PASS=
_APP_REDIS_USER=
COMPOSE_PROFILES=mariadb,mongodb,postgresql
_APP_DOMAIN_TARGET_CNAME=cname.localhost
_APP_CUSTOM_DOMAIN_DENY_LIST=
_APP_DNS=172.16.238.100
_APP_OPTIONS_FORCE_HTTPS=disabled
_APP_OPTIONS_ROUTER_FORCE_HTTPS=disabled
_APP_OPTIONS_ROUTER_PROTECTION=disabled
_APP_OPTIONS_ABUSE=disabled
_APP_CONSOLE_DOMAIN=localhost
_APP_CONSOLE_HOSTNAMES=localhost,appwrite.io,*.appwrite.io
_APP_CONSOLE_SCHEMA=appwriteio
_APP_CONSOLE_SESSION_ALERTS=enabled
_APP_CONSOLE_TRUSTED_PROJECTS=trusted-project,another-trusted-project
_APP_CONSOLE_COUNTRIES_DENYLIST=AQ
_APP_CONSOLE_WHITELIST_EMAILS=
_APP_CONSOLE_WHITELIST_IPS=
_APP_CONSOLE_WHITELIST_ROOT=disabled
_APP_DB_ADAPTER=mongodb
_APP_DB_HOST=mongodb
_APP_DB_PORT=27017
@@ -47,18 +42,27 @@ _APP_DB_SCHEMA=appwrite
_APP_DB_USER=user
_APP_DB_PASS=password
_APP_DB_ROOT_PASS=rootsecretpassword
_APP_DATABASE_SHARED_TABLES=
_APP_DATABASE_SHARED_NAMESPACE=
_APP_DATABASE_SHARED_TABLES=
_APP_DB_ADAPTER_DOCUMENTSDB=mongodb
_APP_DB_HOST_DOCUMENTSDB=mongodb
_APP_DB_PORT_DOCUMENTSDB=27017
_APP_DB_ADAPTER_VECTORSDB=postgresql
_APP_DB_HOST_VECTORSDB=postgresql
_APP_DB_PORT_VECTORSDB=5432
_APP_EMBEDDING_MODELS=nomic-embed-text
_APP_REDIS_HOST=redis
_APP_REDIS_PORT=6379
_APP_REDIS_USER=
_APP_REDIS_PASS=
_APP_EMBEDDING_ENDPOINT='http://appwrite-embedding:3000/embed'
_APP_EMBEDDING_MODELS=nomic-embed-text
_APP_EMBEDDING_TIMEOUT=30000
_APP_STORAGE_DEVICE=Local
_APP_STORAGE_LIMIT=30000000
_APP_STORAGE_PREVIEW_LIMIT=20000000
_APP_STORAGE_ANTIVIRUS=disabled
_APP_STORAGE_ANTIVIRUS_HOST=clamav
_APP_STORAGE_ANTIVIRUS_PORT=3310
_APP_STORAGE_S3_ACCESS_KEY=
_APP_STORAGE_S3_SECRET=
_APP_STORAGE_S3_REGION=us-east-1
@@ -80,9 +84,11 @@ _APP_STORAGE_WASABI_ACCESS_KEY=
_APP_STORAGE_WASABI_SECRET=
_APP_STORAGE_WASABI_REGION=eu-central-1
_APP_STORAGE_WASABI_BUCKET=
_APP_STORAGE_ANTIVIRUS=disabled
_APP_STORAGE_ANTIVIRUS_HOST=clamav
_APP_STORAGE_ANTIVIRUS_PORT=3310
_APP_SYSTEM_EMAIL_NAME=Appwrite
_APP_SYSTEM_EMAIL_ADDRESS=noreply@appwrite.io
_APP_SYSTEM_TEAM_EMAIL=team@appwrite.io
_APP_EMAIL_SECURITY=security@appwrite.io
_APP_EMAIL_CERTIFICATES=certificates@appwrite.io
_APP_SMTP_HOST=maildev
_APP_SMTP_PORT=1025
_APP_SMTP_SECURE=
@@ -91,67 +97,56 @@ _APP_SMTP_PASSWORD=password
_APP_SMS_PROVIDER=sms://username:password@mock
_APP_SMS_FROM=+123456789
_APP_SMS_PROJECTS_DENY_LIST=
_APP_STORAGE_LIMIT=30000000
_APP_STORAGE_PREVIEW_LIMIT=20000000
_APP_MESSAGE_EMAIL_TEST_DSN=
_APP_MESSAGE_PUSH_TEST_DSN=
_APP_MESSAGE_SMS_TEST_DSN=
_APP_COMPUTE_SIZE_LIMIT=30000000
_APP_FUNCTIONS_TIMEOUT=900
_APP_SITES_TIMEOUT=30
_APP_COMPUTE_BUILD_TIMEOUT=900
_APP_COMPUTE_CPUS=8
_APP_COMPUTE_MEMORY=8192
_APP_COMPUTE_INACTIVE_THRESHOLD=600
_APP_COMPUTE_MAINTENANCE_INTERVAL=600
_APP_COMPUTE_RUNTIMES_NETWORK=runtimes
_APP_EXECUTOR_SECRET=your-secret-key
_APP_EXECUTOR_HOST=http://exc1/v1
_APP_BROWSER_HOST=http://appwrite-browser:3000/v1
_APP_FUNCTIONS_RUNTIMES=node-22
_APP_FUNCTIONS_TIMEOUT=900
_APP_FUNCTIONS_CREATION_ABUSE_LIMIT=5000
_APP_SITES_RUNTIMES=static-1,node-22
_APP_SITES_TIMEOUT=30
_APP_EXECUTOR_HOST=http://exc1/v1
_APP_EXECUTOR_SECRET=your-secret-key
_APP_EXECUTOR_IMAGES=openruntimes/node:v5-22,openruntimes/static:v5-1
_APP_BROWSER_HOST=http://appwrite-browser:3000/v1
_APP_DOCKER_HUB_USERNAME=
_APP_DOCKER_HUB_PASSWORD=
_APP_MAINTENANCE_INTERVAL=86400
_APP_MAINTENANCE_START_TIME=12:00
_APP_MAINTENANCE_RETENTION_CACHE=2592000
_APP_MAINTENANCE_RETENTION_EXECUTION=1209600
_APP_MAINTENANCE_RETENTION_ABUSE=86400
_APP_MAINTENANCE_RETENTION_AUDIT=1209600
_APP_MAINTENANCE_RETENTION_AUDIT_CONSOLE=15778800
_APP_USAGE_AGGREGATION_INTERVAL=30
_APP_STATS_RESOURCES_INTERVAL=30
_APP_MAINTENANCE_RETENTION_USAGE_HOURLY=8640000
_APP_MAINTENANCE_RETENTION_CACHE=2592000
_APP_MAINTENANCE_RETENTION_EXECUTION=1209600
_APP_MAINTENANCE_RETENTION_SCHEDULES=86400
_APP_INTERVAL_DOMAIN_VERIFICATION=120
_APP_MAINTENANCE_RETENTION_USAGE_HOURLY=8640000
_APP_INTERVAL_CLEANUP_STALE_EXECUTIONS=300
_APP_INTERVAL_DOMAIN_VERIFICATION=120
_APP_USAGE_AGGREGATION_INTERVAL=30
_APP_USAGE_STATS=enabled
_APP_LOGGING_CONFIG=
_APP_LOGGING_CONFIG_REALTIME=
_APP_STATS_RESOURCES_INTERVAL=30
_APP_GRAPHQL_INTROSPECTION=enabled
_APP_GRAPHQL_MAX_BATCH_SIZE=10
_APP_GRAPHQL_MAX_COMPLEXITY=250
_APP_GRAPHQL_MAX_DEPTH=4
_APP_DOCKER_HUB_USERNAME=
_APP_DOCKER_HUB_PASSWORD=
_APP_VCS_GITHUB_APP_NAME=
_APP_VCS_GITHUB_PRIVATE_KEY=disabled
_APP_VCS_GITHUB_APP_ID=
_APP_VCS_GITHUB_CLIENT_ID=
_APP_VCS_GITHUB_CLIENT_SECRET=
_APP_VCS_GITHUB_WEBHOOK_SECRET=
_APP_ASSISTANT_OPENAI_API_KEY=
_APP_LOGGING_CONFIG=
_APP_LOGGING_CONFIG_REALTIME=
_APP_MIGRATION_HOST=appwrite
_APP_MIGRATIONS_FIREBASE_CLIENT_ID=
_APP_MIGRATIONS_FIREBASE_CLIENT_SECRET=
_APP_ASSISTANT_OPENAI_API_KEY=
_APP_MESSAGE_SMS_TEST_DSN=
_APP_MESSAGE_EMAIL_TEST_DSN=
_APP_MESSAGE_PUSH_TEST_DSN=
_APP_WEBHOOK_MAX_FAILED_ATTEMPTS=10
_APP_PROJECT_REGIONS=default
_APP_FUNCTIONS_CREATION_ABUSE_LIMIT=5000
_APP_STATS_USAGE_DUAL_WRITING_DBS=database_db_main
_APP_TRUSTED_HEADERS=x-forwarded-for
_APP_POOL_ADAPTER=stack
_APP_WORKER_SCREENSHOTS_ROUTER=http://appwrite
_TESTS_OAUTH2_GITHUB_CLIENT_ID=
_TESTS_OAUTH2_GITHUB_CLIENT_SECRET=
_APP_WORKERS_NUM=1
_APP_WORKER_MAX_COROUTINES=1
_APP_REALTIME_TAIL_RATE=50
_APP_VCS_GITHUB_APP_ID=
_APP_VCS_GITHUB_APP_NAME=
_APP_VCS_GITHUB_CLIENT_ID=
_APP_VCS_GITHUB_CLIENT_SECRET=
_APP_VCS_GITHUB_PRIVATE_KEY=disabled
_APP_VCS_GITHUB_WEBHOOK_SECRET=
_APP_WEBHOOK_MAX_FAILED_ATTEMPTS=10
+13 -9
View File
@@ -161,6 +161,8 @@ docker run -it --rm `
| | [PHP 快速开始](https://appwrite.io/docs/quick-starts/php) |
| | [Kotlin 快速开始](https://appwrite.io/docs/quick-starts/kotlin) |
| | [Swift 快速开始](https://appwrite.io/docs/quick-starts/swift) |
| | [Go 快速开始](https://appwrite.io/docs/quick-starts/go) |
| | [Rust 快速开始](https://appwrite.io/docs/quick-starts/rust) |
### 软件服务
@@ -185,20 +187,22 @@ docker run -it --rm `
- :white_check_mark:   [Web](https://github.com/appwrite/sdk-for-web) (由 Appwrite 团队维护)
- :white_check_mark:   [Flutter](https://github.com/appwrite/sdk-for-flutter) (由 Appwrite 团队维护)
- :white_check_mark:   [Apple](https://github.com/appwrite/sdk-for-apple) - **公测** (由 Appwrite 团队维护)
- :white_check_mark:   [Apple](https://github.com/appwrite/sdk-for-apple) (由 Appwrite 团队维护)
- :white_check_mark:   [Android](https://github.com/appwrite/sdk-for-android) (由 Appwrite 团队维护)
- :white_check_mark:   [React Native](https://github.com/appwrite/sdk-for-react-native) - **公测** (由 Appwrite 团队维护)
#### 服务器
- :white_check_mark:   [NodeJS](https://github.com/appwrite/sdk-for-node) (由 Appwrite 团队维护)
- :white_check_mark:   [PHP](https://github.com/appwrite/sdk-for-php) (由 Appwrite 团队维护)
- :white_check_mark:   [Dart](https://github.com/appwrite/sdk-for-dart) - (由 Appwrite 团队维护)
- :white_check_mark:   [Deno](https://github.com/appwrite/sdk-for-deno) - **公测** (由 Appwrite 团队维护)
- :white_check_mark:   [Ruby](https://github.com/appwrite/sdk-for-ruby) (由 Appwrite 团队维护)
- :white_check_mark:   [Node.js](https://github.com/appwrite/sdk-for-node) (由 Appwrite 团队维护)
- :white_check_mark:   [Python](https://github.com/appwrite/sdk-for-python) (由 Appwrite 团队维护)
- :white_check_mark:   [Kotlin](https://github.com/appwrite/sdk-for-kotlin) - **公测** (由 Appwrite 团队维护)
- :white_check_mark:   [Apple](https://github.com/appwrite/sdk-for-apple) - **公测** (由 Appwrite 团队维护)
- :white_check_mark:   [.NET](https://github.com/appwrite/sdk-for-dotnet) - **公测** (由 Appwrite 团队维护)
- :white_check_mark:   [Dart](https://github.com/appwrite/sdk-for-dart) (由 Appwrite 团队维护)
- :white_check_mark:   [PHP](https://github.com/appwrite/sdk-for-php) (由 Appwrite 团队维护)
- :white_check_mark:   [Ruby](https://github.com/appwrite/sdk-for-ruby) (由 Appwrite 团队维护)
- :white_check_mark:   [.NET](https://github.com/appwrite/sdk-for-dotnet) (由 Appwrite 团队维护)
- :white_check_mark:   [Go](https://github.com/appwrite/sdk-for-go) (由 Appwrite 团队维护)
- :white_check_mark:   [Swift](https://github.com/appwrite/sdk-for-swift) (由 Appwrite 团队维护)
- :white_check_mark:   [Kotlin](https://github.com/appwrite/sdk-for-kotlin) (由 Appwrite 团队维护)
- :white_check_mark:   [Rust](https://github.com/appwrite/sdk-for-rust) (由 Appwrite 团队维护)
#### 开发者社区
+10 -7
View File
@@ -166,6 +166,8 @@ Getting started with Appwrite is as easy as creating a new project, choosing you
| | [Quick start for PHP](https://appwrite.io/docs/quick-starts/php) |
| | [Quick start for Kotlin](https://appwrite.io/docs/quick-starts/kotlin) |
| | [Quick start for Swift](https://appwrite.io/docs/quick-starts/swift) |
| | [Quick start for Go](https://appwrite.io/docs/quick-starts/go) |
| | [Quick start for Rust](https://appwrite.io/docs/quick-starts/rust) |
### SDKs
@@ -181,15 +183,16 @@ Below is a list of currently supported platforms and languages. If you would lik
#### Server
- :white_check_mark:   [NodeJS](https://github.com/appwrite/sdk-for-node)
- :white_check_mark:   [PHP](https://github.com/appwrite/sdk-for-php)
- :white_check_mark:   [Dart](https://github.com/appwrite/sdk-for-dart)
- :white_check_mark:   [Deno](https://github.com/appwrite/sdk-for-deno)
- :white_check_mark:   [Ruby](https://github.com/appwrite/sdk-for-ruby)
- :white_check_mark:   [Node.js](https://github.com/appwrite/sdk-for-node)
- :white_check_mark:   [Python](https://github.com/appwrite/sdk-for-python)
- :white_check_mark:   [Kotlin](https://github.com/appwrite/sdk-for-kotlin)
- :white_check_mark:   [Swift](https://github.com/appwrite/sdk-for-swift)
- :white_check_mark:   [Dart](https://github.com/appwrite/sdk-for-dart)
- :white_check_mark:   [PHP](https://github.com/appwrite/sdk-for-php)
- :white_check_mark:   [Ruby](https://github.com/appwrite/sdk-for-ruby)
- :white_check_mark:   [.NET](https://github.com/appwrite/sdk-for-dotnet)
- :white_check_mark:   [Go](https://github.com/appwrite/sdk-for-go)
- :white_check_mark:   [Swift](https://github.com/appwrite/sdk-for-swift)
- :white_check_mark:   [Kotlin](https://github.com/appwrite/sdk-for-kotlin)
- :white_check_mark:   [Rust](https://github.com/appwrite/sdk-for-rust)
Looking for more SDKs? - Help us by contributing a pull request to our [SDK Generator](https://github.com/appwrite/sdk-generator)!
+4 -4
View File
@@ -14,7 +14,7 @@ $image = $this->getParam('image', '');
$enableAssistant = $this->getParam('enableAssistant', false);
$executorImages = $this->getParam('executorImages', '');
$dbService = $this->getParam('database', 'mongodb');
$allowedDbServices = ['mariadb', 'mongodb'];
$allowedDbServices = ['mariadb', 'mongodb', 'postgresql'];
if (!\in_array($dbService, $allowedDbServices, true)) {
$dbService = 'mongodb';
}
@@ -194,7 +194,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/');
appwrite-console:
<<: *x-logging
container_name: appwrite-console
image: <?php echo $organization; ?>/console:7.8.26
image: <?php echo $organization; ?>/console:8.7.5
restart: unless-stopped
networks:
- appwrite
@@ -1003,7 +1003,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/');
environment:
- OPR_EXECUTOR_CONNECTION_STORAGE=local://localhost
- OPR_EXECUTOR_CONNECTION_BUILD_CACHE_STORAGE=
- OPR_EXECUTOR_IMAGES=<?php echo $executorImages; ?>
- OPR_EXECUTOR_IMAGES=<?php echo $executorImages . "\n"; ?>
- OPR_EXECUTOR_INACTIVE_TRESHOLD=$_APP_COMPUTE_INACTIVE_THRESHOLD
- OPR_EXECUTOR_MAINTENANCE_INTERVAL=$_APP_COMPUTE_MAINTENANCE_INTERVAL
- OPR_EXECUTOR_NETWORK=$_APP_COMPUTE_RUNTIMES_NETWORK
@@ -1126,7 +1126,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/');
exec mongod --replSet rs0 --bind_ip_all --auth --keyFile "$$KEYFILE_PATH"
healthcheck:
test: |
mongosh -u root -p "$$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin --quiet --eval "rs.status().ok" | grep -q 1
mongosh -u root -p "$$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin --quiet --eval "const hello = db.adminCommand({hello: 1}); if (!hello.isWritablePrimary) { quit(1); }"
interval: 10s
timeout: 10s
retries: 10
+8 -8
View File
@@ -1,16 +1,16 @@
<?php
$isUpgrade = $isUpgrade ?? false;
$lockedDatabase = $lockedDatabase ?? null;
$vars = $vars ?? [];
$defaultHttpPort = $defaultHttpPort ?? '80';
$defaultHttpsPort = $defaultHttpsPort ?? '443';
$isUpgrade ??= false;
$lockedDatabase ??= null;
$vars ??= [];
$defaultHttpPort ??= '80';
$defaultHttpsPort ??= '443';
$defaultAppDomain = $vars['_APP_DOMAIN']['default'] ?? 'localhost';
$defaultAppDomain = ($defaultAppDomain === 'traefik') ? 'localhost' : $defaultAppDomain;
$defaultEmailCertificates = $defaultEmailCertificates ?? '';
$defaultEmailCertificates ??= '';
$defaultDatabase = $vars['_APP_DB_ADAPTER']['default'] ?? 'mongodb';
$lockedDatabase = $isUpgrade && empty($lockedDatabase) ? $defaultDatabase : $lockedDatabase;
$enabledDatabases = $enabledDatabases ?? ['mongodb', 'mariadb', 'postgresql'];
$isLocalInstall = $isLocalInstall ?? false;
$enabledDatabases ??= ['mongodb', 'mariadb'];
$isLocalInstall ??= false;
$cardStep = ($step === 5) ? 4 : $step;
@@ -4,8 +4,8 @@
const getLockedDatabase = () => getBodyDataset().lockedDatabase || '';
const getEnabledDatabases = () => {
const raw = getBodyDataset().enabledDatabases;
if (!raw) return ['mongodb', 'mariadb', 'postgresql'];
try { return JSON.parse(raw); } catch (e) { return ['mongodb', 'mariadb', 'postgresql']; }
if (!raw) return ['mongodb', 'mariadb'];
try { return JSON.parse(raw); } catch (e) { return ['mongodb', 'mariadb']; }
};
const STEP_IDS = Object.freeze({
+2 -2
View File
@@ -432,11 +432,11 @@
const secretKey = root?.querySelector('#secret-key');
const secretValue = secretKey?.value.trim() || '';
if (!secretKey || !secretValue) {
setFieldError?.(secretKey, 'Please enter or generate a secret API key');
setFieldError?.(secretKey, 'Please enter or generate a secret key');
return false;
}
if (secretValue.length > 64) {
setFieldError?.(secretKey, 'Secret API key must be 1-64 characters');
setFieldError?.(secretKey, 'Secret key must be 1-64 characters');
return false;
}
}
@@ -1,13 +1,13 @@
<?php
$isUpgrade = $isUpgrade ?? false;
$lockedDatabase = $lockedDatabase ?? null;
$defaultAppDomain = $defaultAppDomain ?? 'localhost';
$defaultHttpPort = $defaultHttpPort ?? '80';
$defaultHttpsPort = $defaultHttpsPort ?? '443';
$defaultEmailCertificates = $defaultEmailCertificates ?? '';
$defaultAssistantOpenAIKey = $defaultAssistantOpenAIKey ?? '';
$defaultDatabase = $defaultDatabase ?? 'mongodb';
$enabledDatabases = $enabledDatabases ?? ['mongodb', 'mariadb', 'postgresql'];
$isUpgrade ??= false;
$lockedDatabase ??= null;
$defaultAppDomain ??= 'localhost';
$defaultHttpPort ??= '80';
$defaultHttpsPort ??= '443';
$defaultEmailCertificates ??= '';
$defaultAssistantOpenAIKey ??= '';
$defaultDatabase ??= 'mongodb';
$enabledDatabases ??= ['mongodb', 'mariadb'];
$selectedDatabase = $lockedDatabase ?: $defaultDatabase;
$isDatabaseLocked = !empty($lockedDatabase);
$mongoEnabled = in_array('mongodb', $enabledDatabases, true);
@@ -27,7 +27,7 @@ $secretKeyValue = htmlspecialchars((string) $defaultSecretKey, ENT_QUOTES, 'UTF-
<div class="input-row">
<div class="input-group stack-xs">
<label for="secret-key" class="label-text typography-text-m-500 text-neutral-secondary">Secret API key</label>
<label for="secret-key" class="label-text typography-text-m-500 text-neutral-secondary">Secret key</label>
<div class="input-action">
<input
type="text"
@@ -67,7 +67,7 @@ $badgeClass = $defaultSecretKey !== '' ? 'badge-success' : 'badge-warning';
<span class="badge <?php echo $badgeClass; ?> typography-text-xs-400" data-review-badge>
<?php echo htmlspecialchars((string) $badgeLabel, ENT_QUOTES, 'UTF-8'); ?>
</span>
<div class="review-label typography-text-xs-400 text-neutral-tertiary">Secret API key</div>
<div class="review-label typography-text-xs-400 text-neutral-tertiary">Secret key</div>
</div>
<?php } ?>
</div>
+2 -1
View File
@@ -16,7 +16,8 @@ services:
ME_CONFIG_BASICAUTH_USERNAME: ${_APP_DB_USER}
ME_CONFIG_BASICAUTH_PASSWORD: ${_APP_DB_PASS}
depends_on:
- mongodb
mongodb:
condition: service_healthy
adminer:
image: adminer
+16 -10
View File
@@ -255,7 +255,7 @@ services:
appwrite-console:
<<: *x-logging
container_name: appwrite-console
image: appwrite/console:8
image: appwrite/console:8.7.5
restart: unless-stopped
networks:
- appwrite
@@ -1254,7 +1254,6 @@ services:
restart: unless-stopped
networks:
- appwrite
- runtimes
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- appwrite-builds:/storage/builds:rw
@@ -1266,7 +1265,7 @@ services:
environment:
- OPR_EXECUTOR_CONNECTION_STORAGE=local://localhost
- OPR_EXECUTOR_CONNECTION_BUILD_CACHE_STORAGE=
- OPR_EXECUTOR_IMAGE_PULL=enabled
- OPR_EXECUTOR_IMAGES=$_APP_EXECUTOR_IMAGES
- OPR_EXECUTOR_INACTIVE_TRESHOLD=$_APP_COMPUTE_INACTIVE_THRESHOLD
- OPR_EXECUTOR_MAINTENANCE_INTERVAL=$_APP_COMPUTE_MAINTENANCE_INTERVAL
- OPR_EXECUTOR_NETWORK=$_APP_COMPUTE_RUNTIMES_NETWORK
@@ -1353,13 +1352,20 @@ services:
healthcheck:
test: |
bash -c "
if mongosh -u root -p ${_APP_DB_ROOT_PASS} --authenticationDatabase admin --quiet --eval 'rs.status().ok' 2>/dev/null | grep -q 1; then
exit 0
else
mongosh -u root -p ${_APP_DB_ROOT_PASS} --authenticationDatabase admin --quiet --eval \"
rs.initiate({_id: 'rs0', members: [{_id: 0, host: 'appwrite-mongodb:27017'}]})
\" 2>/dev/null || exit 1
fi
mongosh -u root -p ${_APP_DB_ROOT_PASS} --authenticationDatabase admin --quiet --eval \"
try {
const hello = db.adminCommand({hello: 1});
if (hello.isWritablePrimary) {
quit(0);
}
} catch (e) {}
try {
rs.initiate({_id: 'rs0', members: [{_id: 0, host: 'appwrite-mongodb:27017'}]});
} catch (e) {}
quit(1);
\" 2>/dev/null
"
interval: 10s
timeout: 10s
+8 -3
View File
@@ -57,7 +57,7 @@ class Install extends Action
->param('image', 'appwrite', new Text(0), 'Main appwrite docker image', true)
->param('interactive', 'Y', new Text(1), 'Run an interactive session', true)
->param('no-start', false, new Boolean(true), 'Run an interactive session', true)
->param('database', 'mongodb', new WhiteList(['mongodb', 'mariadb', 'postgresql']), 'Database to use (mongodb|mariadb|postgresql)', true)
->param('database', 'mongodb', new WhiteList(['mongodb', 'mariadb']), 'Database to use (mongodb|mariadb)', true)
->callback($this->action(...));
}
@@ -102,6 +102,8 @@ class Install extends Action
$envFileExists = file_exists($this->path . '/' . $this->getEnvFileName());
$existingInstallation = $data !== '' || $envFileExists;
$existingDatabase = null;
if ($existingInstallation) {
$time = \time();
$composeFileName = $this->getComposeFileName();
@@ -171,7 +173,6 @@ class Install extends Action
// Detect database type from existing installation.
// 1.9.0+ installs have _APP_DB_ADAPTER; pre-1.9.0 installs
// can be detected by the DB service name or _APP_DB_HOST.
$existingDatabase = null;
foreach ($compose->getServices() as $service) {
$svcEnv = $service->getEnvironment()->list();
if (isset($svcEnv['_APP_DB_ADAPTER'])) {
@@ -200,7 +201,8 @@ class Install extends Action
$installerConfig = $this->readInstallerConfig();
$enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb'];
if (!in_array($database, $enabledDatabases, true)) {
$isExistingDatabase = $isUpgrade && $existingDatabase !== null && $database === $existingDatabase;
if (!in_array($database, $enabledDatabases, true) && !$isExistingDatabase) {
Console::error("Database '{$database}' is not available. Available options: " . implode(', ', $enabledDatabases));
Console::exit(1);
}
@@ -332,6 +334,9 @@ class Install extends Action
$installerConfig = $this->readInstallerConfig();
$enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb'];
if ($isUpgrade && $lockedDatabase !== null && !in_array($lockedDatabase, $enabledDatabases, true)) {
$enabledDatabases[] = $lockedDatabase;
}
$this->setInstallerConfig([
'defaultHttpPort' => $defaultHttpPort,