From a67a614b9f77bbb2a7e2f412792f29b67ee14047 Mon Sep 17 00:00:00 2001 From: ShadowArcanist Date: Mon, 21 Apr 2025 18:12:07 +0530 Subject: [PATCH 1/4] New Deployments Docs WIP --- docs/.vitepress/config.mts | 19 ++++++++++++++++++ docs/deployments/introduction.md | 7 +++++++ .../deployments/introduction/banner.webp | Bin 0 -> 13938 bytes 3 files changed, 26 insertions(+) create mode 100644 docs/deployments/introduction.md create mode 100644 docs/public/images/deployments/introduction/banner.webp diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 684950ee..d4914684 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -146,6 +146,25 @@ export default defineConfig({ { text: 'Build Servers', link: '/builds/servers' }, ], }, + { + text: 'Deployments', + collapsed: true, + items: [ + { text: 'Introduction', link: '/deployments/introduction' }, + // { + // text: 'Build Packs', + // collapsed: true, + // items: [ + // { text: 'Overview', link: '/builds/packs/overview' }, + // { text: 'Static', link: '/builds/packs/static' }, + // { text: 'Nixpacks', link: '/builds/packs/nixpacks' }, + // { text: 'Dockerfile', link: '/builds/packs/dockerfile' }, + // { text: 'Docker Compose', link: '/builds/packs/docker-compose' }, + // ] + // }, + // { text: 'Build Servers', link: '/builds/servers' }, + ], + }, { text: 'Applications', collapsed: true, diff --git a/docs/deployments/introduction.md b/docs/deployments/introduction.md new file mode 100644 index 00000000..68a0f8b0 --- /dev/null +++ b/docs/deployments/introduction.md @@ -0,0 +1,7 @@ +--- +title: Introduction to Deployments +--- + + + +
diff --git a/docs/public/images/deployments/introduction/banner.webp b/docs/public/images/deployments/introduction/banner.webp new file mode 100644 index 0000000000000000000000000000000000000000..a605738429cebfb5feefdc7d5d6adfc721dc2e24 GIT binary patch literal 13938 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 S>MVh%%)S5!m&<+t;Qs&-CyEOI literal 0 HcmV?d00001 From a20a761000463343012aa6cff0114c24695c86e2 Mon Sep 17 00:00:00 2001 From: ShadowArcanist Date: Mon, 21 Apr 2025 18:35:37 +0530 Subject: [PATCH 2/4] Added Deployments Introduction page - WIP --- docs/builds/introduction.md | 49 ++++++++++++++----------------------- 1 file changed, 19 insertions(+), 30 deletions(-) diff --git a/docs/builds/introduction.md b/docs/builds/introduction.md index 61b25b85..9b67cdb2 100644 --- a/docs/builds/introduction.md +++ b/docs/builds/introduction.md @@ -1,42 +1,31 @@ --- -title: Introduction to Builds +title: Introduction to Deployments --- - +
-Coolify deploys all applications as Docker containers. This means your app, database, or website runs inside a container. +A deployment is the process of releasing a specific version of your application (packaged as a Docker container) to one or more environments. Coolify makes it easy to push updates, preview changes before they go live, and ensure your users never experience downtime. -No matter what you deploy or which build pack you use, it is always run as a Docker container. +## How Deployments Work +- **Container Registry:** Every deployment pulls a Docker image—either built by Coolify or pre–built and pushed to a registry (e.g., Docker Hub, GitHub Container Registry). +- **Deployment Configuration:** You define which image tag to deploy and any runtime settings (environment variables, ports, volumes, secrets). +- **Release Strategy:** Coolify supports multiple deployment strategies to match your needs: + - **Rolling Updates:** Gradually replace old containers with new ones to maintain availability. + - **Instant Rollback:** If something goes wrong, revert to the previous version with a single click. -## How Docker Containers Work -- **Docker Image:** To run a container, you need a Docker image. -- **Dockerfile:** The image is built using a Dockerfile, just a file with step-by-step instructions to build the docker image. -- **Build Process:** If you're building your own application, you'll need to create your docker image using a Dockerfile. - - Coolify helps with this build process by letting you use different build packs. A commonly used build pack is [Nixpacks ↗](https://nixpacks.com?utm_source=coolify.io), which automatically prepares a Dockerfile and builds the docker image for you. +## Preview Deployments +- **On‑Demand Previews:** Spin up a temporary environment for each pull request or branch, complete with its own URL. +- **Automatic Cleanup:** Preview deployments are automatically torn down when the branch is closed or merged. -## Build Packs in Coolify -Coolify offers build packs like [Nixpack ↗](https://nixpacks.com?utm_source=coolify.io) and **Static Build Pack** that automatically create your Docker image. +## Zero‑Downtime Deployments +- **Health Checks & Readiness Probes:** Coolify waits for new containers to pass health checks before routing traffic. +- **Graceful Shutdown:** Old containers are drained of active connections before being terminated. -If you need more control over the process, you can write your own Dockerfile and Docker Compose file. In that case, Coolify will use your file to build the image on the server and deploy it as a container. - - -## Using Pre-built Images -If you already have a Docker image stored in a registry (for example, [Docker Hub ↗](https://hub.docker.com/?utm_source=coolify.io) or [GitHub Container Registry ↗](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry?utm_source=coolify.io)), you can use that image directly in Coolify. This means you do not have to rebuild the image on your server. - - -## Managing Build Resources -Building Docker images can consume a lot of resources on your server, potentially causing it to crash. - -To reduce the load on your main server, Coolify allows you to connect additional servers to manage the build process. - -You can set up a separate [build server ↗](/builds/servers) to handle the builds, or use external tools like [GitHub Actions ↗](https://github.com/features/actions?utm_source=coolify.io) to build your images and push them to any container registry. - -Once the images are pushed, you can easily use them on Coolify. - - -## What's Next? -Check the pages in the sidebar to learn more about build packs, build commands, and build servers. +## What’s Next? +Explore the pages in the sidebar to learn more about: +- [Preview Deployments ↗](/deployments/previews) +- [Rollbacks ↗](/deployments/rollbacks) From 6c69ada57d959e4e756dd8e287aa2682926014bb Mon Sep 17 00:00:00 2001 From: ShadowArcanist Date: Mon, 21 Apr 2025 18:37:19 +0530 Subject: [PATCH 3/4] Fixed the previous commit.... edited the wrong introduction.md file --- docs/builds/introduction.md | 49 +++++++++++++++++++------------- docs/deployments/introduction.md | 24 ++++++++++++++++ 2 files changed, 54 insertions(+), 19 deletions(-) diff --git a/docs/builds/introduction.md b/docs/builds/introduction.md index 9b67cdb2..93fd5266 100644 --- a/docs/builds/introduction.md +++ b/docs/builds/introduction.md @@ -1,31 +1,42 @@ --- -title: Introduction to Deployments +title: Introduction to Builds --- - +
-A deployment is the process of releasing a specific version of your application (packaged as a Docker container) to one or more environments. Coolify makes it easy to push updates, preview changes before they go live, and ensure your users never experience downtime. +Coolify deploys all applications as Docker containers. This means your app, database, or website runs inside a container. -## How Deployments Work -- **Container Registry:** Every deployment pulls a Docker image—either built by Coolify or pre–built and pushed to a registry (e.g., Docker Hub, GitHub Container Registry). -- **Deployment Configuration:** You define which image tag to deploy and any runtime settings (environment variables, ports, volumes, secrets). -- **Release Strategy:** Coolify supports multiple deployment strategies to match your needs: - - **Rolling Updates:** Gradually replace old containers with new ones to maintain availability. - - **Instant Rollback:** If something goes wrong, revert to the previous version with a single click. +No matter what you deploy or which build pack you use, it is always run as a Docker container. -## Preview Deployments -- **On‑Demand Previews:** Spin up a temporary environment for each pull request or branch, complete with its own URL. -- **Automatic Cleanup:** Preview deployments are automatically torn down when the branch is closed or merged. +## How Docker Containers Work +- **Docker Image:** To run a container, you need a Docker image. +- **Dockerfile:** The image is built using a Dockerfile, just a file with step-by-step instructions to build the docker image. +- **Build Process:** If you're building your own application, you'll need to create your docker image using a Dockerfile. + - Coolify helps with this build process by letting you use different build packs. A commonly used build pack is [Nixpacks ↗](https://nixpacks.com?utm_source=coolify.io), which automatically prepares a Dockerfile and builds the docker image for you. -## Zero‑Downtime Deployments -- **Health Checks & Readiness Probes:** Coolify waits for new containers to pass health checks before routing traffic. -- **Graceful Shutdown:** Old containers are drained of active connections before being terminated. +## Build Packs in Coolify +Coolify offers build packs like [Nixpack ↗](https://nixpacks.com?utm_source=coolify.io) and **Static Build Pack** that automatically create your Docker image. -## What’s Next? -Explore the pages in the sidebar to learn more about: -- [Preview Deployments ↗](/deployments/previews) -- [Rollbacks ↗](/deployments/rollbacks) +If you need more control over the process, you can write your own Dockerfile and Docker Compose file. In that case, Coolify will use your file to build the image on the server and deploy it as a container. + + +## Using Pre-built Images +If you already have a Docker image stored in a registry (for example, [Docker Hub ↗](https://hub.docker.com/?utm_source=coolify.io) or [GitHub Container Registry ↗](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry?utm_source=coolify.io)), you can use that image directly in Coolify. This means you do not have to rebuild the image on your server. + + +## Managing Build Resources +Building Docker images can consume a lot of resources on your server, potentially causing it to crash. + +To reduce the load on your main server, Coolify allows you to connect additional servers to manage the build process. + +You can set up a separate [build server ↗](/builds/servers) to handle the builds, or use external tools like [GitHub Actions ↗](https://github.com/features/actions?utm_source=coolify.io) to build your images and push them to any container registry. + +Once the images are pushed, you can easily use them on Coolify. + + +## What's Next? +Check the pages in the sidebar to learn more about build packs, build commands, and build servers. \ No newline at end of file diff --git a/docs/deployments/introduction.md b/docs/deployments/introduction.md index 68a0f8b0..9b67cdb2 100644 --- a/docs/deployments/introduction.md +++ b/docs/deployments/introduction.md @@ -5,3 +5,27 @@ title: Introduction to Deployments
+ +A deployment is the process of releasing a specific version of your application (packaged as a Docker container) to one or more environments. Coolify makes it easy to push updates, preview changes before they go live, and ensure your users never experience downtime. + +## How Deployments Work +- **Container Registry:** Every deployment pulls a Docker image—either built by Coolify or pre–built and pushed to a registry (e.g., Docker Hub, GitHub Container Registry). +- **Deployment Configuration:** You define which image tag to deploy and any runtime settings (environment variables, ports, volumes, secrets). +- **Release Strategy:** Coolify supports multiple deployment strategies to match your needs: + - **Rolling Updates:** Gradually replace old containers with new ones to maintain availability. + - **Instant Rollback:** If something goes wrong, revert to the previous version with a single click. + + +## Preview Deployments +- **On‑Demand Previews:** Spin up a temporary environment for each pull request or branch, complete with its own URL. +- **Automatic Cleanup:** Preview deployments are automatically torn down when the branch is closed or merged. + + +## Zero‑Downtime Deployments +- **Health Checks & Readiness Probes:** Coolify waits for new containers to pass health checks before routing traffic. +- **Graceful Shutdown:** Old containers are drained of active connections before being terminated. + +## What’s Next? +Explore the pages in the sidebar to learn more about: +- [Preview Deployments ↗](/deployments/previews) +- [Rollbacks ↗](/deployments/rollbacks) From c92b0483c2e951c4f0416ba33573b45b4afafdfe Mon Sep 17 00:00:00 2001 From: ShadowArcanist Date: Mon, 21 Apr 2025 18:44:32 +0530 Subject: [PATCH 4/4] Prepared Sidebar for deployments new contents - WIP --- docs/.vitepress/config.mts | 58 ++++++++++++++++++++++++++++++-------- 1 file changed, 46 insertions(+), 12 deletions(-) diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index d4914684..8f119df6 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -151,18 +151,52 @@ export default defineConfig({ collapsed: true, items: [ { text: 'Introduction', link: '/deployments/introduction' }, - // { - // text: 'Build Packs', - // collapsed: true, - // items: [ - // { text: 'Overview', link: '/builds/packs/overview' }, - // { text: 'Static', link: '/builds/packs/static' }, - // { text: 'Nixpacks', link: '/builds/packs/nixpacks' }, - // { text: 'Dockerfile', link: '/builds/packs/dockerfile' }, - // { text: 'Docker Compose', link: '/builds/packs/docker-compose' }, - // ] - // }, - // { text: 'Build Servers', link: '/builds/servers' }, + { text: 'Automatic Deployments', link: '/deployments/introduction' }, + { text: 'Preview Deployments', link: '/deployments/introduction' }, + { text: 'Git-based Deployments', link: '/deployments/introduction' }, + { text: 'Docker-based Deployments', link: '/deployments/introduction' }, + { text: 'Multi-Server Deployments', link: '/deployments/introduction' }, + { + text: 'One Click Deployments', + collapsed: true, + items: [ + { + text: 'Databases', + collapsed: true, + items: [ + { text: 'PostgreSQL', link: '/builds/packs/overview' }, + { text: 'MySQL', link: '/builds/packs/static' }, + { text: 'Redis', link: '/builds/packs/nixpacks' }, + { text: 'Dragonfly', link: '/builds/packs/dockerfile' }, + { text: 'Clickhouse', link: '/builds/packs/docker-compose' }, + ] + }, + { + text: 'Services', + collapsed: true, + items: [ + { text: 'A', link: '/builds/packs/overview' }, + { text: 'B', link: '/builds/packs/static' }, + { text: 'C', link: '/builds/packs/nixpacks' }, + { text: 'D', link: '/builds/packs/dockerfile' }, + { text: 'E', link: '/builds/packs/docker-compose' }, + ] + }, + ] + }, + { text: 'Rollbacks', link: '/deployments/introduction' }, + { text: 'Presistent Storages', link: '/deployments/introduction' }, + { text: 'Custom Domains', link: '/deployments/introduction' }, + { + text: 'SSL Certificates', + collapsed: true, + items: [ + { text: 'Lets Encrypt', link: '/builds/packs/overview' }, + { text: 'Cloudflare', link: '/builds/packs/static' }, + { text: 'Hetzner', link: '/builds/packs/nixpacks' }, + ] + }, + { text: 'DNS Configuration', link: '/deployments/introduction' }, ], }, {