Skip to content

Add CloudRay deployment Guide #11935

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions public/logos/cloudray.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions src/components/DeployGuidesNav.astro
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ const services: Service[] = [
{ title: 'Kinsta', slug: 'kinsta', supports: ['ssr', 'static'] },
{ title: 'Zeabur', slug: 'zeabur', supports: ['ssr', 'static'] },
{ title: 'Zerops', slug: 'zerops', supports: ['ssr', 'static'] },
{ title: 'CloudRay', slug: 'cloudray', supports: ['static'] },
];
---

Expand Down
38 changes: 38 additions & 0 deletions src/content/docs/en/guides/deploy/cloudray.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: Deploy your Astro Site with CloudRay
description: How to deploy your Astro site to your Ubuntu Server using CloudRay
sidebar:
label: CloudRay
type: deploy
i18nReady: true
---
import { Steps } from '@astrojs/starlight/components';

You can deploy your Astro project using [CloudRay](https://cloudray.io), a centralized platform that helps you manage your servers, organize Bash scripts, and automate deployment tasks across virtual machines and cloud servers.

:::note
CloudRay itself does not host your site. Instead, it provides automation tools to run deployment scripts on your own infrastructure (e.g., Ubuntu servers) using a connected agent.
:::

## Prerequisites

To get started, you will need:

- A [CloudRay Account](https://app.cloudray.io)
- Your app code stored in a [GitHub](https://github.com/) repository

## How to Deploy through CloudRay Dashboard

Deploying with CloudRay typically involves three main steps:

<Steps>
1. Install the [CloudRay Agent](https://cloudray.io/docs/agent) on your server to securely register your machine and enable remote automation.

2. In your CloudRay Dashboard, write a reusable Bash script that clones your Astro repo, installs dependencies, builds your site, and configures a web server. Define any repo-specific values using [CloudRay’s variable groups](https://cloudray.io/docs/variable-groups).

3. Use CloudRay’s Runlog interface to execute your script on your connected server and monitor the deployment in real time.
</Steps>

## Official Resources

Check out [the Astro guide in CloudRay's docs](https://cloudray.io/articles/how-to-deploy-your-astro-site).
1 change: 1 addition & 0 deletions src/data/logos.ts
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ export const logos = LogoCheck({
cleavr: { file: 'cleavr.svg', padding: '0.125em 0.125em 0.1375em' },
cloudflare: { file: 'cloudflare-pages.svg', padding: '.1875em' },
cloudinary: { file: 'cloudinary.svg', padding: '.1875em' },
cloudray: { file: 'cloudray.svg', padding: '0' },
'craft-cms': { file: 'craft-cms.svg', padding: '.225em' },
crystallize: { file: 'crystallize.svg', padding: '.1875em' },
'create-react-app': { file: 'create-react-app.svg', padding: '.1875em' },
Expand Down