Skip to content

Commit

Permalink
fix: Expired discord link
Browse files Browse the repository at this point in the history
  • Loading branch information
dogmar committed Nov 14, 2023
1 parent 0b356af commit d2048d4
Show file tree
Hide file tree
Showing 10 changed files with 26 additions and 22 deletions.
24 changes: 11 additions & 13 deletions cli-readme/README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
# Welcome to Your Plural Repo

This is the repo that will house all your Plural installations for this cluster. We'll give you a quick walkthrough how everything works here. In general, there are two commands you'll run in your Plural workflow:
This is the repo that will house all your Plural installations for this cluster. We'll give you a quick walkthrough how everything works here. In general, there are two commands you'll run in your Plural workflow:

```
plural build // generates infrastructure as code for your installations
plural deploy // deploys your IAC resources in dependency-order
```


If you want to install a new app, you can run:

```
Expand All @@ -21,7 +20,7 @@ If you want an at-a-glance view of the health of any application, you can run:
plural watch APP_NAME
```

but the best way to manage and monitor your applications is with the Plural Console, which you can install with `plural bundle install console console-{aws,gcp,azure,etc}`. We strongly recommend doing this.
but the best way to manage and monitor your applications is with the Plural Console, which you can install with `plural bundle install console console-{aws,gcp,azure,etc}`. We strongly recommend doing this.

## Workspace Structure

Expand All @@ -42,33 +41,32 @@ We generate infrastructure as code resources in a consistent format:
- main.tf # can override submodule configuration here, see that file for more info
```

In general we expect you to customize the repo as you wish, and any standard Terraform or Helm command should work as expected. Let's say you wanted to switch the database for an app to RDS. To do this, you can use the app's dedicated Terraform folder in the repo to define the database and inject its secret into Kubernetes right there.
In general we expect you to customize the repo as you wish, and any standard Terraform or Helm command should work as expected. Let's say you wanted to switch the database for an app to RDS. To do this, you can use the app's dedicated Terraform folder in the repo to define the database and inject its secret into Kubernetes right there.
There are two other metadata files you should be aware of as well:

* `context.yaml` - this is the initial app configuration you provide when running `plural bundle install`. We use this to generate the resources that are present in your app folder above. You can reconfigure settings here if you'd like, or occasionally enable different configurations. Airbyte basic auth requires a `context.yaml` change for instance.
- `context.yaml` - this is the initial app configuration you provide when running `plural bundle install`. We use this to generate the resources that are present in your app folder above. You can reconfigure settings here if you'd like, or occasionally enable different configurations. Airbyte basic auth requires a `context.yaml` change for instance.

* `workspace.yaml` - this is the high level workspace metadata about your workspace, like the cloud account, cluster name, dns domain, etc. For the most part, this file should remain read-only.
- `workspace.yaml` - this is the high level workspace metadata about your workspace, like the cloud account, cluster name, dns domain, etc. For the most part, this file should remain read-only.

## Secret Management

We automatically encrypt this repo using a go reimplementation of [git-crypt](https://github.com/AGWA/git-crypt). You'll be able to see the AES key you're currently using with `plural crypto export`. We also drop the key fingerprint into the repo at `.keyid` to validate and provide appropriate error messages.
We automatically encrypt this repo using a go reimplementation of [git-crypt](https://github.com/AGWA/git-crypt). You'll be able to see the AES key you're currently using with `plural crypto export`. We also drop the key fingerprint into the repo at `.keyid` to validate and provide appropriate error messages.

It's strongly recommended you backup this key, and we provide a backup API for you with `plural crypto backups create`. You can sync any backup with `plural crypto backups resource NAME`. You can also use popular solutions for this like 1password, Vault or your cloud's secrets manager.
It's strongly recommended you backup this key, and we provide a backup API for you with `plural crypto backups create`. You can sync any backup with `plural crypto backups resource NAME`. You can also use popular solutions for this like 1password, Vault or your cloud's secrets manager.

If you reclone this repo on a new machine, its contents will be fully encrypted. In that case you'll need to set up the encryption credentials for the repo, then run:
If you reclone this repo on a new machine, its contents will be fully encrypted. In that case you'll need to set up the encryption credentials for the repo, then run:

```
plural crypto init
plural crypto unlock
```


## Destroying Your Cluster

You can tear down the cluster at any time using `plural destroy`. If it gets jammed on a specific app, you can simply rerun with `plural destroy --from APP_NAME`.
You can tear down the cluster at any time using `plural destroy`. If it gets jammed on a specific app, you can simply rerun with `plural destroy --from APP_NAME`.

In break glass scenarios where destroy doesn't want to behave, the bulk of the cloud resources are in the bootstrap app, and you can simply run `cd bootstrap && terraform destroy` manually. If you encounter this feel free to let us know so we can improve our packaging.
In break glass scenarios where destroy doesn't want to behave, the bulk of the cloud resources are in the bootstrap app, and you can simply run `cd bootstrap && terraform destroy` manually. If you encounter this feel free to let us know so we can improve our packaging.

## Support

If you have any issues with plural or any of the apps in the catalog, we pride ourselves on providing prompt support. You can join our Discord at [https://discord.gg/pluralsh](https://discord.gg/pluralsh) and we'll try to troubleshoot the issue for you. You can find common troubleshooting tips [here](https://docs.plural.sh/reference/troubleshooting) as well.
If you have any issues with plural or any of the apps in the catalog, we pride ourselves on providing prompt support. You can join our Discord [here](https://discord.com/invite/bEBAMXV64s), and we'll try to troubleshoot the issue for you. You can find common troubleshooting tips [here](https://docs.plural.sh/reference/troubleshooting) as well.
2 changes: 1 addition & 1 deletion pages/applications/dagster.mdpart
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,6 @@ Only do this if you're absolutely sure you want to bring down all associated res

## Troubleshooting

If you run into any issues with installing Dagster on Plural, feel free to join our [Discord Community](https://discord.gg/pluralsh) so that we can help you out.
If you run into any issues with installing Dagster on Plural, feel free to join our [Discord Community](https://discord.com/invite/bEBAMXV64s) so that we can help you out.

If you'd like to request any updates or new features for our Dagster installation, feel free to open an issue [here](https://github.com/pluralsh/plural-artifacts).
4 changes: 2 additions & 2 deletions pages/getting-started/cloud-shell-quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ When your applications are finished installing, you'll be able to see the domain

Occasionally errors can crop up during the build and deploy process. If your build or deploy fails, you can try re-running the commands to see if it resolves an intermittent issue. To do this, click into the terminal window and either tap the up arrow key to see the last command or type in `plural build && plural deploy --commit "deploying a few apps with plural"` to relaunch the process from where it left off and commit your changes when finished.

If errors persist, check out our [Troubleshooting documentation](/debugging/common-errors) or [reach out to us on our community Discord](https://discord.gg/pluralsh) for help.
If errors persist, check out our [Troubleshooting documentation](/debugging/common-errors) or [reach out to us on our community Discord](https://discord.com/invite/bEBAMXV64s) for help.

## Check out your Deployments

Expand Down Expand Up @@ -253,4 +253,4 @@ plural shell purge

### Feedback

If you have any feedback or questions about the experience, [head over to our community Discord](https://discord.gg/pluralsh) and drop us some feedback. The Cloud Shell is still in development and we are dedicated to perfecting the user experience, so any feedback would be immensely helpful to us.
If you have any feedback or questions about the experience, [head over to our community Discord](https://discord.com/invite/bEBAMXV64s) and drop us some feedback. The Cloud Shell is still in development and we are dedicated to perfecting the user experience, so any feedback would be immensely helpful to us.
3 changes: 2 additions & 1 deletion pages/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ import { Heading as MarkdocHeading } from '@pluralsh/design-system/dist/markdoc/
import styled, { useTheme } from 'styled-components'

import { mqs } from '@src/components/Breakpoints'
import { DISCORD_LINK } from '@src/consts'

const Hero = styled.div(({ theme }) => ({
background: 'url(/images/landing/hero-bg-sm.png)',
Expand Down Expand Up @@ -256,7 +257,7 @@ function Index() {
<CardLink
heading="Discord"
icon={<DiscordIcon />}
href="https://discord.gg/pluralsh"
href={DISCORD_LINK}
target="_blank"
rel="nofollow noreferrer"
>
Expand Down
2 changes: 1 addition & 1 deletion pages/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ We have created a Cloud Shell with all of the tools and dependencies needed to r

- [Using our in-browser Cloud Shell](/getting-started/cloud-shell-quickstart)

If you need support getting your Plural deployment up and running, join the [Plural Discord here!](https://discord.gg/pluralsh)
If you need support getting your Plural deployment up and running, join the [Plural Discord here!](https://discord.com/invite/bEBAMXV64s)

## Architecture

Expand Down
2 changes: 1 addition & 1 deletion pages/reference/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -160,4 +160,4 @@ cd application-name/terraform
terraform import path_to_terraform_resource resource_id
```

If you devise a better way to recover crashed terraform state, please give us a shout in our [Discord](https://discord.gg/pluralsh). We'd love to automate this better.
If you devise a better way to recover crashed terraform state, please give us a shout in our [Discord](https://discord.com/invite/bEBAMXV64s). We'd love to automate this better.
4 changes: 3 additions & 1 deletion src/components/MobileMenu.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ import { DiscordIcon } from '@pluralsh/design-system'
import styled from 'styled-components'
import { useIsomorphicLayoutEffect } from 'usehooks-ts'

import { DISCORD_LINK } from '@src/consts'

import { FullNav } from './FullNav'
import GithubStars from './GithubStars'
import useScrollLock from './hooks/useScrollLock'
Expand Down Expand Up @@ -38,7 +40,7 @@ function PluralMenuContent({
<MainLink href="https://app.plural.sh/login">Sign in</MainLink>
<SocialIcons>
<SocialLink
href="https://discord.gg/pluralsh"
href={DISCORD_LINK}
target="_blank"
rel="noopener noreferrer"
tabIndex={0}
Expand Down
4 changes: 3 additions & 1 deletion src/components/PageHeader.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ import { useRouter } from 'next/router'
import { useKey } from 'rooks'
import styled, { useTheme } from 'styled-components'

import { DISCORD_LINK } from '@src/consts'

import { BreakpointIsGreaterOrEqual, mqs, useBreakpoint } from './Breakpoints'
import GithubStars from './GithubStars'
import MobileMenu from './MobileMenu'
Expand Down Expand Up @@ -61,7 +63,7 @@ function PageHeaderUnstyled({ ...props }) {
<div className="socialIcons">
<SocialLink
className="discordIcon"
href="https://discord.gg/pluralsh"
href={DISCORD_LINK}
target="_blank"
rel="noopener noreferrer"
tabIndex={0}
Expand Down
1 change: 1 addition & 0 deletions src/consts.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,4 @@ export const getAppMetaDescription = (displayName?: string) => {

return `How to easily install and manage ${displayName} on Kubernetes using Plural.`
}
export const DISCORD_LINK = 'https://discord.com/invite/bEBAMXV64s'
2 changes: 1 addition & 1 deletion src/generated/pages.json
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@
"path": "/deployments/browser-quickstart"
},
{
"path": "/deployments/ci-example"
"path": "/deployments/ci-gh-actions"
},
{
"path": "/deployments/ci-overview"
Expand Down

0 comments on commit d2048d4

Please sign in to comment.