|
| 1 | +# Deploying to 21YunBox |
| 2 | + |
| 3 | +[21YunBox](https://www.21yunbox.com) provides blazing fast Chinese CDN, [continuous deployment](/docs/glossary/continuous-deployment), one-click HTTPS and [other services like managed databases and backend web services](https://www.21yunbox.com/docs/v2/index.html), providing an avenue to launch web projects in China. |
| 4 | + |
| 5 | +21YunBox includes the following features: |
| 6 | + |
| 7 | +- Continuous, automatic builds & deploys from GitHub and Gitee |
| 8 | +- Automatic SSL certificates through [Let's Encrypt](https://letsencrypt.org) |
| 9 | +- Instant cache invalidation with a blazing fast, Chinese CDN |
| 10 | +- Unlimited [custom domains](https://www.21yunbox.com/docs/v2/custom-domains.html) |
| 11 | +- Automatic [Brotli compression](https://en.wikipedia.org/wiki/Brotli) for faster sites |
| 12 | +- Native HTTP/2 support |
| 13 | +- Automatic HTTP → HTTPS redirects |
| 14 | +- Custom URL redirects and rewrites |
| 15 | + |
| 16 | +## Prerequisites |
| 17 | + |
| 18 | +This guide assumes you already have a Gatsby project to deploy. If you need a project, use the [quick Start](/docs/quick-start) to get started or fork 21YunBox's [Gatsby Example](https://github.com/tobyglei/gatsby) before continuing. |
| 19 | + |
| 20 | +## Setup |
| 21 | + |
| 22 | +You can set up a Gatsby site on 21YunBox in two quick steps: |
| 23 | + |
| 24 | +1. Create a new web service on 21YunBox, and give 21YunBox permission to access your GitHub or Gitee repo. |
| 25 | +2. Use the following values during creation: |
| 26 | + |
| 27 | + | | | |
| 28 | + | --------------------- | ------------------------------------------------ | |
| 29 | + | **Environment** | `Static Site` | |
| 30 | + | **Build Command** | `yarn && yarn build` (or your own build command) | |
| 31 | + | **Publish Directory** | `./public` (or your own output directory) | |
| 32 | + |
| 33 | +That's it! Your site will be live on your 21YunBox URL (which looks like `yoursite.21yunbox.com`) as soon as the build is done. |
| 34 | + |
| 35 | +## Continuous deploys |
| 36 | + |
| 37 | +Now that 21YunBox is connected to your repo, it will automatically build and publish your site any time you push to GitHub. |
| 38 | + |
| 39 | +## 21YunBox CDN and cache invalidation |
| 40 | + |
| 41 | +21YunBox hosts your site on a Chinese, blazing fast CDN which ensures the fastest possible download times for all your users across China. |
| 42 | + |
| 43 | +Every deploy automatically and instantly invalidates the CDN cache, so your users can always access the latest content on your site. |
| 44 | + |
| 45 | +## Custom domains |
| 46 | + |
| 47 | +Add your own domains to your site easily using 21YunBox's [custom domains](https://www.21yunbox.com/docs/v2/custom-domains.html) guide. |
0 commit comments