Skip to content

Commit

Permalink
fix: update references to kubefirst for Kubefirst
Browse files Browse the repository at this point in the history
  • Loading branch information
mrsimonemms committed Nov 11, 2024
1 parent 4c15023 commit 22329ec
Show file tree
Hide file tree
Showing 65 changed files with 163 additions and 163 deletions.
2 changes: 1 addition & 1 deletion .vale/Custom/ignore.txt
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ iam

# K
kubeconfig
kubefirst
Kubefirst
kubernetes

# L
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Firstly, we want to thank you for investing your valuable time to contribute to

Note we have a [code of conduct](CODE_OF_CONDUCT.md) which needs to be followed in all your interactions with the project to keep our community healthy.

_For contribution to the Kubefirst CLI, please refer yourself to the [CONTRIBUTING.md](https://github.com/konstructio/kubefirst/blob/main/CONTRIBUTING.md) from the [kubefirst repository](https://github.com/konstructio/kubefirst)._
_For contribution to the Kubefirst CLI, please refer yourself to the [CONTRIBUTING.md](https://github.com/konstructio/kubefirst/blob/main/CONTRIBUTING.md) from the [Kubefirst repository](https://github.com/konstructio/kubefirst)._

- [Ways to Contribute](#ways-to-contribute)
- [Getting Started](#getting-started)
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
</picture>
</p>

# kubefirst Docs
# Kubefirst Docs

Welcome to the open source repository that powers [the Kubefirst documentation](https://kubefirst.konstruct.io/docs).

Expand Down
2 changes: 1 addition & 1 deletion docs/akamai/partials/common/_installed-applications.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
### Installed Applications

To see what is installed by kubefirst, check the [overview page](../../overview.mdx).
To see what is installed by Kubefirst, check the [overview page](../../overview.mdx).
2 changes: 1 addition & 1 deletion docs/akamai/partials/common/_prerequisites.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
### Akamai Prerequisites

For kubefirst to be able to provision your Akamai cloud resources:
For Kubefirst to be able to provision your Akamai cloud resources:

- A [Akamai account](https://www.akamai.com/create-account) in which you are an account owner.
- A [Linode API token](https://cloud.linode.com/profile/tokens).
2 changes: 1 addition & 1 deletion docs/akamai/partials/github/_cluster-create.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import CloudflareDNS from "../../../common/partials/common/_cloudflare-dns.mdx";

## Create your new kubefirst cluster
## Create your new Kubefirst cluster

Adjust the following command with your GitHub and Akamai (Linode) tokens in addition to the appropriate values for your new platform.

Expand Down
2 changes: 1 addition & 1 deletion docs/akamai/partials/gitlab/_cluster-create.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import CloudflareDNS from "../../../common/partials/common/_cloudflare-dns.mdx";

## Create your new kubefirst cluster
## Create your new Kubefirst cluster

Adjust the following command with your GitHub and Akamai (Linode) tokens in addition to the appropriate values for your new platform.

Expand Down
2 changes: 1 addition & 1 deletion docs/aws/advanced/certificates.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@ import AWSLogo from '../../img/aws/logo.svg';

## SSL Certificates

In cloud versions of the kubefirst platform, we use [cert-manager](https://cert-manager.io/) with a [Let's Encrypt](https://letsencrypt.org) ClusterIssuer for TLS encryption to all of our services on Ingress. These certificates are requested automatically, and will auto-renew.
In cloud versions of the Kubefirst platform, we use [cert-manager](https://cert-manager.io/) with a [Let's Encrypt](https://letsencrypt.org) ClusterIssuer for TLS encryption to all of our services on Ingress. These certificates are requested automatically, and will auto-renew.
2 changes: 1 addition & 1 deletion docs/aws/advanced/security.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ import AWSLogo from '../../img/aws/logo.svg';

## Installation Account

kubefirst runs against your public cloud provider and leverages your personal cloud credentials in order to conduct the provisioning of the kubefirst platform. We do not embed your credentials into the platform in any way, they are only used during the installation process.
Kubefirst runs against your public cloud provider and leverages your personal cloud credentials in order to conduct the provisioning of the Kubefirst platform. We do not embed your credentials into the platform in any way, they are only used during the installation process.

## Granular Kubernetes Service Accounts with Explicit IAM Roles for Cloud Access

Expand Down
2 changes: 1 addition & 1 deletion docs/aws/partials/common/_ecr.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
:::tip

By default kubefirst use the Git provider you selected as container registry. With AWS, you have the option to use EKS instead. To do so, add the flag `--ecr` with the value `true` to your cluster creation command.
By default Kubefirst use the Git provider you selected as container registry. With AWS, you have the option to use EKS instead. To do so, add the flag `--ecr` with the value `true` to your cluster creation command.

:::
2 changes: 1 addition & 1 deletion docs/aws/partials/github/_cluster-create.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
import CloudflareDNS from "../../../common/partials/common/_cloudflare-dns.mdx";
import ECR from "../common/_ecr.mdx";

## Create your new kubefirst cluster
## Create your new Kubefirst cluster

Adjust the following command with your GitHub token in addition to the appropriate values for your new platform.

Expand Down
2 changes: 1 addition & 1 deletion docs/aws/partials/gitlab/_cluster-create.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
import CloudflareDNS from "../../../common/partials/common/_cloudflare-dns.mdx";
import ECR from "../common/_ecr.mdx";

## Create your new kubefirst cluster
## Create your new Kubefirst cluster

Adjust the following command with your GitLab token in addition to the appropriate values for your new platform.

Expand Down
2 changes: 1 addition & 1 deletion docs/civo/partials/common/_installed-applications.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
### Installed Applications

To see what is installed by kubefirst, check the [overview page](../../overview.mdx).
To see what is installed by Kubefirst, check the [overview page](../../overview.mdx).
4 changes: 2 additions & 2 deletions docs/civo/partials/common/_prerequisites.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
### Civo Prerequisites

For kubefirst to be able to provision your Civo cloud resources:
For Kubefirst to be able to provision your Civo cloud resources:

- A [Civo account](https://dashboard.civo.com/signup) in which you are an account owner.
- A publicly routable [DNS](https://www.civo.com/learn/configure-dns#adding-a-domain-name).
- A [Civo token](https://dashboard.civo.com/security).

:::info
kubefirst is keeping low the resources needed to create your Kubernetes cluster, but if you are already using Civo, note that you may have exceeding quota issues during the creation process.
Kubefirst is keeping low the resources needed to create your Kubernetes cluster, but if you are already using Civo, note that you may have exceeding quota issues during the creation process.

Civo has a quota based on a combined allocation of instances/Kubernetes nodes, CPUs, RAM usage, and other resources. All customers start with a [basic quota level](https://www.civo.com/docs/account/quota), but you can [request quota increase](https://www.civo.com/docs/account/quota#requesting-a-quota-increase).
:::
2 changes: 1 addition & 1 deletion docs/civo/partials/github/_cluster-create.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import CloudflareDNS from "../../../common/partials/common/_cloudflare-dns.mdx";

## Create your new kubefirst cluster
## Create your new Kubefirst cluster

Adjust the following command with your GitHub and Civo tokens in addition to the appropriate values for your new platform.

Expand Down
2 changes: 1 addition & 1 deletion docs/civo/partials/gitlab/_cluster-create.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import CloudflareDNS from "../../../common/partials/common/_cloudflare-dns.mdx";

## Create your new kubefirst cluster
## Create your new Kubefirst cluster

Adjust the following command with your GitHub and Civo tokens in addition to the appropriate values for your new platform.

Expand Down
16 changes: 8 additions & 8 deletions docs/civo/quick-start/install/marketplace.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@ sidebar_position: 1
image: "https://kubefirst.konstruct.io/docs/img/kubefirst.svg"
---

# Install kubefirst using the Civo Marketplace
# Install Kubefirst using the Civo Marketplace

You can create a temporary kubefirst installer cluster through the Civo Kubernetes marketplace, and use it to create your kubefirst management cluster.
You can create a temporary Kubefirst installer cluster through the Civo Kubernetes marketplace, and use it to create your Kubefirst management cluster.

## Create your installer cluster

Expand All @@ -20,9 +20,9 @@ Log into your Civo account and navigate to [Kubernetes](https://dashboard.civo.c
5. In the Marketplace section select `kubefirst`
6. Click Create Cluster and wait until the cluster is ready

![kubefirst user interface showing cloud and git options](../../../img/civo/marketplace/installer-options.png)
![Kubefirst user interface showing cloud and git options](../../../img/civo/marketplace/installer-options.png)

## Connect to the install cluster and the kubefirst installer service
## Connect to the install cluster and the Kubefirst installer service

In your terminal, run the following commands to download and use your new cluster's kubeconfig. This example assumes you named your cluster `installer`.

Expand All @@ -35,12 +35,12 @@ Then launch the installer in your browser:

[http://localhost:8080/](http://localhost:8080/)

## Create your kubefirst management cluster
## Create your Kubefirst management cluster

Provide details about your preferred Git provider, access, and cluster details and let kubefirst do the rest.
Provide details about your preferred Git provider, access, and cluster details and let Kubefirst do the rest.

![kubefirst user interface showing cloud and git options](../../../img/civo/marketplace/create-management.png)
![Kubefirst user interface showing cloud and git options](../../../img/civo/marketplace/create-management.png)

## Deleting your installer cluster

Once you've successfully installed your kubefirst `management` cluster, you can delete the `installer` cluster directly in the Civo UI. It is only used to establish the platform.
Once you've successfully installed your Kubefirst `management` cluster, you can delete the `installer` cluster directly in the Civo UI. It is only used to establish the platform.
12 changes: 6 additions & 6 deletions docs/common/clusters.mdx
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
The kubefirst 2.3 release introduces Kubernetes cluster lifecycle management to the platform to provide our users with the ability to create their own opinionated workload clusters in a way that takes advantage of their management cluster. We're introducing both physical clusters, which will be created in your cloud account, as well as virtual clusters, which are also isolated Kubernetes clusters, but which run inside your management cluster.
The Kubefirst 2.3 release introduces Kubernetes cluster lifecycle management to the platform to provide our users with the ability to create their own opinionated workload clusters in a way that takes advantage of their management cluster. We're introducing both physical clusters, which will be created in your cloud account, as well as virtual clusters, which are also isolated Kubernetes clusters, but which run inside your management cluster.

![cluster creation in kubefirst user interface](../img/kubefirst/getting-started/cluster-creation.gif)
![cluster creation in Kubefirst user interface](../img/kubefirst/getting-started/cluster-creation.gif)

## GitOps-Oriented Workload Clusters

By default, a new kubefirst will provide you with 2 template-driven directories that will drive how your workload clusters are created.
By default, a new Kubefirst will provide you with 2 template-driven directories that will drive how your workload clusters are created.

![cluster template directories in GitOps repository](../img/kubefirst/getting-started/cluster-template.png)

Expand Down Expand Up @@ -33,9 +33,9 @@ If you inspect your templates for cluster and vcluster, you'll find them to be v
- you can customize this template in your `gitops` repository as your needs require

:::tip
The kubefirst Console "Physical Clusters" feature will be the first feature of our upcoming Pro tier. We'd love for you to try it out and tell us what you think during its free introductory period.
The Kubefirst Console "Physical Clusters" feature will be the first feature of our upcoming Pro tier. We'd love for you to try it out and tell us what you think during its free introductory period.

We plan to keep the kubefirst Console "Virtual Clusters" feature on the Community tier at no cost.
We plan to keep the Kubefirst Console "Virtual Clusters" feature on the Community tier at no cost.

You will always be able to create anything you need on your own without our user interface, and we hope you find that starting point immensely valuable. We hope to earn your business with our management interface. Thank you sincerely to all of our customers.
:::
Expand All @@ -48,4 +48,4 @@ Cluster creation takes about 6 minutes to fully sync in Argo CD for virtual clus

Your workload cluster will have a starting point app-of-apps in Argo CD in the `clusters` app and will share your cluster's name.

When you delete a cluster, kubefirst will remove the binding from your management cluster so that it begins deleting in Argo CD, but we must leave the directory there so that the apps can remove gracefully. You're free to remove it once cluster deprovisioning has completed successfully. Deletion takes time to deprovision resources - can be anywhere from 5 to 15 minutes depending on the cloud. Be patient and inspect the deprovision operation in Argo CD.
When you delete a cluster, Kubefirst will remove the binding from your management cluster so that it begins deleting in Argo CD, but we must leave the directory there so that the apps can remove gracefully. You're free to remove it once cluster deprovisioning has completed successfully. Deletion takes time to deprovision resources - can be anywhere from 5 to 15 minutes depending on the cloud. Be patient and inspect the deprovision operation in Argo CD.
4 changes: 2 additions & 2 deletions docs/common/credits.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## The Tools We Love

The kubefirst platform uses some of the most popular open source projects in the world, and some closed sources ones (as little as possible). This page is dedicated to giving those projects credit for their incredible offerings.
The Kubefirst platform uses some of the most popular open source projects in the world, and some closed sources ones (as little as possible). This page is dedicated to giving those projects credit for their incredible offerings.

- [Actions Runner Controller](https://github.com/actions/actions-runner-controller) ([Apache 2.0](https://github.com/external-secrets/external-secrets/blob/main/LICENSE))
- [Argo CD](https://github.com/argoproj/argo-cd) ([Apache 2.0](https://github.com/argoproj/argo-cd/blob/master/LICENSE))
Expand All @@ -27,7 +27,7 @@ The kubefirst platform uses some of the most popular open source projects in the
- [vcluster](https://github.com/loft-sh/vcluster) ([Apache 2.0](https://github.com/loft-sh/vcluster/blob/main/LICENSE))

:::note
Please evaluate each licenses for third-party products used by kubefirst to validate if you can legally use them for your specific use case and legal status.
Please evaluate each licenses for third-party products used by Kubefirst to validate if you can legally use them for your specific use case and legal status.
:::

### Additional References
Expand Down
14 changes: 7 additions & 7 deletions docs/common/deprovision.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,13 @@ import GetAkamaiKubeconfig from '../akamai/partials/common/_get-kubeconfig.mdx';

# Deprovision

To destroy your kubefirst cluster, complete the following steps.
To destroy your Kubefirst cluster, complete the following steps.

## Prerequisites

### kubefirst CLI
### Kubefirst CLI

If you are coming from a cloud marketplace, and didn't use the kubefirst CLI, you will need to install it first.
If you are coming from a cloud marketplace, and didn't use the Kubefirst CLI, you will need to install it first.

```shell
brew install konstructio/taps/kubefirst
Expand Down Expand Up @@ -125,7 +125,7 @@ This will collect the required variables from the necessary secret path and outp
If for some reason, Vault wasn't correctly deployed and initiated when you created your cluster, this step won't generate a proper `.env` file. You will still need to continue the deprovision process as it doesn't mean the cluster or other resources weren't created properly. You will either need to set some environment variable manually (see the tip at the [Cloud Provider](#cloud-provider) step to see all values needed) or provide them to Terraform when asked.
:::

Next, you will need to clone the `gitops` repository generated by kubefirst during the initial cluster creation:
Next, you will need to clone the `gitops` repository generated by Kubefirst during the initial cluster creation:

```shell
# GitHub
Expand All @@ -147,7 +147,7 @@ Switch to the `terraform` directory inside of the cloned `gitops` repository. Fo
cd gitops/terraform
```

Within the `terraform` directory, there are several subdirectories that contain the infrastructure-as-code declarations for your kubefirst resources.
Within the `terraform` directory, there are several subdirectories that contain the infrastructure-as-code declarations for your Kubefirst resources.

#### Cloud Provider

Expand Down Expand Up @@ -189,7 +189,7 @@ terraform init
terraform destroy
```

Once you've destroyed `terraform` resources for the cloud and git providers, the only resource left to clean up is the state storage objects that kubefirst created on your behalf. If you'd like to remove these, this can be achieved by using the cloud console or the command-line utility for your chosen cloud provider.
Once you've destroyed `terraform` resources for the cloud and git providers, the only resource left to clean up is the state storage objects that Kubefirst created on your behalf. If you'd like to remove these, this can be achieved by using the cloud console or the command-line utility for your chosen cloud provider.

You can now delete the `gitops` repository you cloned on your computer, and the `.env` file:

Expand All @@ -201,7 +201,7 @@ rm .env

### Console UI

No matter is you created your new cluster, using the CLI directly (`kubefirst <cloud> create`) or by using the console UI (`kubefirst launch up`), kubefirst will have created a k3d cluster in Docker. We call it the cluster 0, which is either used to display the Console UI, or to connect to our API and create your new kubefirst cluster directly from the CLI. Since it's not needed anymore, you need to destroy it by running:
No matter is you created your new cluster, using the CLI directly (`kubefirst <cloud> create`) or by using the console UI (`kubefirst launch up`), Kubefirst will have created a k3d cluster in Docker. We call it the cluster 0, which is either used to display the Console UI, or to connect to our API and create your new Kubefirst cluster directly from the CLI. Since it's not needed anymore, you need to destroy it by running:

```shell
kubefirst launch down
Expand Down
Loading

0 comments on commit 22329ec

Please sign in to comment.