Skip to content

docs: add Scaleway provider draft - #376

Draft
simple-agent-manager[bot] wants to merge 1 commit into
mainfrom
docs/scaleway-byoc-provider
Draft

simple-agent-manager[bot] wants to merge 1 commit into
mainfrom
docs/scaleway-byoc-provider

Conversation

@simple-agent-manager

Copy link
Copy Markdown
Contributor

Summary

Adds draft Scaleway BYOC provider documentation covering:

  • required Scaleway environment variables and region behavior
  • required Defang config values for Postgres and Redis
  • Serverless Jobs CD flow, Kaniko builds, Secret Manager-backed job secrets, Object Storage state, and Cockpit logs
  • Serverless Containers runtime behavior and background-worker health shim limitations
  • managed Postgres, Redis, and Scaleway Generative API LLM behavior
  • platform limitations discovered during live validation
  • mastra-extended Playwright validation summary

Also links Scaleway from the providers index, BYOC tutorial, and Managed LLM support table.

Validation

defang-docs@0.0.0 prebuild
./scripts/prebuild.sh

Current filename: defang.md
Potential markdown rendering issues: null
Current filename: defang_cert.md
Potential markdown rendering issues: null
Current filename: defang_cert_generate.md
Potential markdown rendering issues: null
Current filename: defang_compose.md
Potential markdown rendering issues: null
Current filename: defang_compose_config.md
Potential markdown rendering issues: null
Current filename: defang_compose_down.md
Potential markdown rendering issues: null
Current filename: defang_compose_logs.md
Potential markdown rendering issues: null
Current filename: defang_compose_ls.md
Potential markdown rendering issues: null
Current filename: defang_compose_ps.md
Potential markdown rendering issues: null
Current filename: defang_compose_up.md
Potential markdown rendering issues: null
Current filename: defang_config.md
Potential markdown rendering issues: null
Current filename: defang_config_create.md
Potential markdown rendering issues: null
Current filename: defang_config_ls.md
Potential markdown rendering issues: null
Current filename: defang_config_resolve.md
Potential markdown rendering issues: null
Current filename: defang_config_rm.md
Potential markdown rendering issues: null
Current filename: defang_deployments.md
Potential markdown rendering issues: null
Current filename: defang_estimate.md
Potential markdown rendering issues: null
Current filename: defang_generate.md
Potential markdown rendering issues: null
Current filename: defang_init.md
Potential markdown rendering issues: null
Current filename: defang_login.md
Potential markdown rendering issues: null
Current filename: defang_logout.md
Potential markdown rendering issues: null
Current filename: defang_logs.md
Potential markdown rendering issues: null
Current filename: defang_mcp.md
Potential markdown rendering issues: null
Current filename: defang_mcp_serve.md
Potential markdown rendering issues: null
Current filename: defang_mcp_setup.md
Potential markdown rendering issues: null
Current filename: defang_services.md
Potential markdown rendering issues: null
Current filename: defang_stack.md
Potential markdown rendering issues: null
Current filename: defang_stack_default.md
Potential markdown rendering issues: null
Current filename: defang_stack_list.md
Potential markdown rendering issues: null
Current filename: defang_stack_new.md
Potential markdown rendering issues: null
Current filename: defang_tail.md
Potential markdown rendering issues: null
Current filename: defang_terms.md
Potential markdown rendering issues: null
Current filename: defang_token.md
Potential markdown rendering issues: null
Current filename: defang_upgrade.md
Potential markdown rendering issues: null
Current filename: defang_version.md
Potential markdown rendering issues: null
Current filename: defang_whoami.md
Potential markdown rendering issues: null
Current filename: defang_workspace.md
Potential markdown rendering issues: null
Current filename: defang_workspace_ls.md
Potential markdown rendering issues: null
@@ Adding agentic-autogen
@@ Added agentic-autogen
@@ Adding agentic-langgraph
@@ Added agentic-langgraph
@@ Adding agentic-strands
@@ Added agentic-strands
@@ Adding angular-express
@@ Added angular-express
@@ Adding arduino-wifi
@@ Added arduino-wifi
@@ Adding bullmq-bullboard-redis
@@ Added bullmq-bullboard-redis
@@ Adding crewai
@@ Added crewai
@@ Adding csharp-dotnet
@@ Added csharp-dotnet
@@ Adding defang-provider-handoff
@@ Added defang-provider-handoff
@@ Adding django
@@ Added django
@@ Adding django-celery
@@ Added django-celery
@@ Adding django-postgres
@@ Added django-postgres
@@ Adding django-railpack
@@ Added django-railpack
@@ Adding django-redis-postgres
@@ Added django-redis-postgres
@@ Adding elysia
@@ Added elysia
@@ Adding fastapi
@@ Added fastapi
@@ Adding fastapi-postgres
@@ Added fastapi-postgres
@@ Adding fastapi-postgres-pubsub
@@ Added fastapi-postgres-pubsub
@@ Adding feathersjs
@@ Added feathersjs
@@ Adding flask
@@ Added flask
@@ Adding flask-railpack
@@ Added flask-railpack
@@ Adding golang-http
@@ Added golang-http
@@ Adding golang-http-form
@@ Added golang-http-form
@@ Adding golang-mongodb
@@ Added golang-mongodb
@@ Adding golang-openai
@@ Added golang-openai
@@ Adding golang-railpack
@@ Added golang-railpack
@@ Adding golang-rest-api
@@ Added golang-rest-api
@@ Adding golang-s3
@@ Added golang-s3
@@ Adding golang-slackbot
@@ Added golang-slackbot
@@ Adding google-adk
@@ Added google-adk
@@ Adding hasura
@@ Added hasura
@@ Adding html-css-js
@@ Added html-css-js
@@ Adding huginn
@@ Added huginn
@@ Adding imgproxy
@@ Added imgproxy
@@ Adding javalin
@@ Added javalin
@@ Adding jupyter-postgres
@@ Added jupyter-postgres
@@ Adding langchain
@@ Added langchain
@@ Adding managed-llm
@@ Added managed-llm
@@ Adding managed-llm-provider
@@ Added managed-llm-provider
@@ Adding mastra-extended
@@ Added mastra-extended
@@ Adding mastra-nextjs
@@ Added mastra-nextjs
@@ Adding mcp
@@ Added mcp
@@ Adding metabase
@@ Added metabase
@@ Adding n8n
@@ Added n8n
@@ Adding nextjs
@@ Added nextjs
@@ Adding nextjs-blog
@@ Added nextjs-blog
@@ Adding nextjs-claude
@@ Added nextjs-claude
@@ Adding nextjs-cv
@@ Added nextjs-cv
@@ Adding nextjs-documentation
@@ Added nextjs-documentation
@@ Adding nextjs-postgres
@@ Added nextjs-postgres
@@ Adding nextjs-railpack
@@ Added nextjs-railpack
@@ Adding nocodb
@@ Added nocodb
@@ Adding nodejs-chatroom
@@ Added nodejs-chatroom
@@ Adding nodejs-express
@@ Added nodejs-express
@@ Adding nodejs-form
@@ Added nodejs-form
@@ Adding nodejs-http
@@ Added nodejs-http
@@ Adding nodejs-openai
@@ Added nodejs-openai
@@ Adding nodejs-react-postgres
@@ Added nodejs-react-postgres
@@ Adding nodejs-rest-api
@@ Added nodejs-rest-api
@@ Adding nodejs-s3
@@ Added nodejs-s3
@@ Adding nounly
@@ Added nounly
@@ Adding ollama
@@ Added ollama
@@ Adding phoenix-postgres
@@ Added phoenix-postgres
@@ Adding platformatic
@@ Added platformatic
@@ Adding pulumi
@@ Added pulumi
@@ Adding pulumi-remix-postgres
@@ Added pulumi-remix-postgres
@@ Adding python-form
@@ Added python-form
@@ Adding python-implicit-gpu
@@ Added python-implicit-gpu
@@ Adding python-minimal
@@ Added python-minimal
@@ Adding python-openai
@@ Added python-openai
@@ Adding python-rest-api
@@ Added python-rest-api
@@ Adding python-s3
@@ Added python-s3
@@ Adding rails
@@ Added rails
@@ Adding react
@@ Added react
@@ Adding react-vite-railpack
@@ Added react-vite-railpack
@@ Adding redis-js
@@ Added redis-js
@@ Adding rocket
@@ Added rocket
@@ Adding sailsjs
@@ Added sailsjs
@@ Adding sailsjs-postgres
@@ Added sailsjs-postgres
@@ Adding svelte-mysql
@@ Added svelte-mysql
@@ Adding sveltekit
@@ Added sveltekit
@@ Adding sveltekit-mongodb
@@ Added sveltekit-mongodb
@@ Adding vllm
@@ Added vllm
@@ Adding vuejs
@@ Added vuejs
@@ Writing samples markdown to /workspaces/defang-global/projects/defang-docs/docs/samples.md

defang-docs@0.0.0 build
docusaurus build

------------------------------------------------------------------------------ Update available 3.9.1 → 3.10.1 To upgrade Docusaurus packages with the latest version, run the following command: npm i @docusaurus/core@latest @docusaurus/plugin-client-redirects@latest @docusaurus/preset-classic@latest @docusaurus/theme-common@latest @docusaurus/theme-mermaid@latest @docusaurus/module-type-aliases@latest @docusaurus/tsconfig@latest @docusaurus/types@latest ------------------------------------------------------------------------------

[INFO] [en] Creating an optimized production build...
[webpackbar] ℹ Compiling Client
[webpackbar] ℹ Compiling Server
[webpackbar] ✔ Server: Compiled successfully in 4.60s
[webpackbar] ✔ Client: Compiled successfully in 4.66s
[SUCCESS] Generated static files in "build".
[INFO] Use npm run serve command to test your build locally.

Build succeeded. Existing unrelated warnings remain for pre-existing broken links/anchors in generated samples, FAQ, migrating-from-heroku, MCP, and AWS docs.

@defangdevs defangdevs left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the content against the actual implementation in the companion PRs (pulumi-defang#234, defang#2105) since those aren't merged yet. Everything checks out:

  • Model aliases (chat-default → llama-3.3-70b-instruct, embedding-default → bge-multilingual-gemma2) match defang#2105.
  • Redis pinned to 8.4.0 matches redisVersionFromImage() in pulumi-defang#234.
  • Postgres password policy (8-128 chars, upper/lower/digit/special) matches the validation tests.
  • Health shim runtime fallback order (node → python3 → python → /bin/sh+nc) matches healthShimScript() exactly.
  • OPENAI_API_KEY auto-provisioning from SCW_SECRET_KEY matches ensureScalewayLLMAuth().
  • min_scale=1 for portless workers / scale-to-zero for services with ports matches containerMinScale().
  • SCW_DEFAULT_REGION default (fr-par) and delegated-domain/DNS limitation match the validation notes in pulumi-defang#234's progress log.
  • sidebar_position: 6 doesn't collide with the existing provider docs (aws=2, gcp=3, azure=4, digitalocean=5).
  • All four doc edits (new scaleway.md, providers/index.mdx, managed-LLM support table, deploy-to-your-cloud.mdx tutorial link) are consistent with each other.

One optional, non-blocking note: the validation log in pulumi-defang#234 mentions compose ps reported the worker as unhealthy (403 Forbidden) even though the container itself was ready — a status-reporting quirk of the health shim path. Worth a one-line mention under "Platform Limitations" if you want to set expectations, but not required since the underlying containers do work.

CI is green and this is accurately scoped as a draft/preview page. Approving.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants