Skip to content

Commit

Permalink
chore: update docs per new functionality
Browse files Browse the repository at this point in the history
  • Loading branch information
armgitaar committed Jan 4, 2024
1 parent 5b07258 commit f55a265
Show file tree
Hide file tree
Showing 3 changed files with 47 additions and 20 deletions.
32 changes: 21 additions & 11 deletions content/documentation/dns-profiles.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: 'DNS Profiles'
description: 'Add DNS profiles to connect notification DNS management accounts.'
image: 'https://docs.cleavr.io/images/cleavr-twitter.png'
video:
title: "DNS Profiles"
description: "Add DNS profiles to connect notification DNS management accounts."
image: "https://docs.cleavr.io/images/cleavr-twitter.png"
video:
---

We try to keep everything a click away in Cleavr. This includes bringing in DNS record management. This makes setting up
Expand All @@ -12,15 +12,25 @@ domains for your sites zoom! 🏎

### [Cloudflare](https://www.cloudflare.com/)

Cloudflare is a web infrastructure and security tool that assists with many valuable services such as DNS record management,
DDoS mitigation, SSL certificate creation and management, and much more. Cloudflare is a great service to use in conjunction
with Cleavr if you are looking for even more layers of protection.
Cloudflare is a web infrastructure and security tool that assists with many valuable services such as DNS record management,
DDoS mitigation, SSL certificate creation and management, and much more. Cloudflare is a great service to use in conjunction
with Cleavr if you are looking for even more layers of protection.

In your Cloudflare account, grab your API Key from your **Profile > API Tokens > View Global API Key**
In your Cloudflare account, grab your API Key from your **Profile > API Tokens > View Global API Key**

### [AWS Route 53](https://aws.amazon.com/route53/)

The Route 53 DNS profile requires an AWS API key that has priveleges for Route 53.

### [DigitalOcean](https://www.digitalocean.com/)

DigitalOcean also provides some DNS record management functions. If you already have DO setup as a VPS provider, you can
use the same **Personal Access Token** to setup the DNS records connection.
DigitalOcean also provides some DNS record management functions. If you already have DO setup as a VPS provider, you can
use the same **Personal Access Token** to setup the DNS records connection.

You will need to ensure that your [domain points to DigitalOcean's nameservers](https://www.digitalocean.com/community/tutorials/how-to-point-to-digitalocean-nameservers-from-common-domain-registrars).

### [Porkbun](https://porkbun.com/)

Porkbun makes it easy to purchase domains. It's also equally as easy to connect to your Porkbun account thru Cleavr to manage DNS records.

You will need to ensure that your [domain points to DigitalOcean's nameservers](https://www.digitalocean.com/community/tutorials/how-to-point-to-digitalocean-nameservers-from-common-domain-registrars).
For creating a new DNS profile for Porkbun, you'll need the email associated with your Porkbun account and an API key which you can create from the Account section.
31 changes: 22 additions & 9 deletions content/documentation/environment-variables.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,35 @@
---
title: 'Environment Variables'
description: 'Manage production environment variables.'
image: 'https://docs.cleavr.io/images/cleavr-twitter.png'
video: ''
title: "Environment Variables"
description: "Manage production environment variables."
image: "https://docs.cleavr.io/images/cleavr-twitter.png"
video: ""
---

## What are environment variables?
Env files typically hold sensitive information for how you apps might connect to other servers, databases, services, etc.

Env files typically hold sensitive information for how you apps might connect to other servers, databases, services, etc.

Cleavr lets you override the production .env file on a server by adding the variables to the environment section.

<base-info>
For this functionality to fully work, you'll need to ensure that your stack supports reading from a .env file in production. Many frameworks support this feature out-of-the-box. Otherwise, you may need to install a package in order to set this up correctly. Lastly, some frameworks are phasing out .env files in production. If this is the situation with the framework you are using, trying adding (or synching) the environment variables with PM2 (for Node-based apps only).
</base-info>

## Configure Deployment Workflow Servers
Navigate to your deployment workflow and select Environment. If you have existing environment variables on a server, you can select the
server and fetch the current variables to then make edits. Otherwise, if a fresh app with no variables, you can use either the
text area to copy and paste from your env file, or you can use the form fields view to enter new variables.

Depending on the type of site (PHP, Alpas, Laravel, etc) you will have post synch options available to run post sync. Such as:
Navigate to your deployment workflow and select Environment. If you have existing environment variables on a server, you can select the
server and fetch the current variables to then make edits. Otherwise, if a fresh app with no variables, you can use either the
text area to copy and paste from your env file, or you can use the form fields view to enter new variables.

Depending on the type of site (PHP, Alpas, Laravel, etc) you will have post synch options available to run post sync. Such as:

- Clear and build config cache (Laravel)
- Reload php-fpm (PHP, Laravel)
- Restart queue (Laravel)
- Restart App (NodeJS, Alpas)

## PM2 Environment Variables

In the Environment section, you can select the option to sync variables with PM2. If you'd like to see the variables, select 'PM2' from the navigation bar to view the PM2 Ecosystem settings.

Some NodeJS frameworks, such as Nuxt and Strapi, are configured to look for production variables from here as opposed to a .env file.
4 changes: 4 additions & 0 deletions content/documentation/vps-profiles.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,8 @@ If you are based in Europe, Hetzner has affordable cloud options for you.

To create a key, go to your project that you created > **Access > API Tokens** and generate api token.

The Hetzner integration supports IPv6 in addition to IPv4.

### [UpCloud](https://upcloud.com/signup/?promo=38D8TP)

With a focus on small / medium businesses and with developer productivity in mind, UpCloud is a great VPS provider
Expand All @@ -48,6 +50,8 @@ DigitalOcean has plenty of global data centers and well-priced options that shou

To create a key, go to **API > personal access tokens** and generate a new key

The DNS integration supports IPv6 in addition to IPv4.

### [AWS](https://aws.amazon.com/)

Amazon Web Services is one of the largest cloud providers in the world. If you are looking for servers that scale with demand,
Expand Down

0 comments on commit f55a265

Please sign in to comment.