Skip to content

Commit

Permalink
marketplace installer docs
Browse files Browse the repository at this point in the history
  • Loading branch information
johndietz committed Aug 17, 2023
1 parent 1b4376f commit 351ea04
Show file tree
Hide file tree
Showing 5 changed files with 52 additions and 4 deletions.
4 changes: 2 additions & 2 deletions docs/civo/quick-start/install/cli.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
hide_title: true
sidebar_label: CLI
sidebar_position: 2
sidebar_label: CLI Installer
sidebar_position: 3
# custom_edit_url: https://github.com/facebook/docusaurus/edit/main/docs/api-doc-markdown.md
image: "https://docs.kubefirst.io/img/logo.svg"
---
Expand Down
48 changes: 48 additions & 0 deletions docs/civo/quick-start/install/marketplace.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
hide_title: true
sidebar_label: Civo Marketplace Installer
sidebar_position: 1
# custom_edit_url: https://github.com/facebook/docusaurus/edit/main/docs/api-doc-markdown.md
image: "https://docs.kubefirst.io/img/logo.svg"
---

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

Log into your Civo account and navigate to Kubernetes

[https://dashboard.civo.com/kubernetes](https://dashboard.civo.com/kubernetes)

1. Click Create New Cluster
2. Name the cluster `installer`
3. Reduce the node count to `1`
4. Increase the node size to `Medium`
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)

## 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`.

```

Check failure on line 30 in docs/civo/quick-start/install/marketplace.mdx

View workflow job for this annotation

GitHub Actions / markdown-check (.mdx, **.mdx, mdx.markdownlint.json)

Fenced code blocks should have a language specified [Context: "```"]

docs/civo/quick-start/install/marketplace.mdx:30 MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
export CLUSTER_NAME=installer
civo kubernetes config $CLUSTER_NAME > ./kubefirst-kubeconfig
export KUBECONFIG=./kubefirst-kubeconfig
kubectl --namespace kubefirst port-forward svc/kubefirst-console 8080:8080
```

Then launch the installer in your browser:

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

## Create your kubefirst management cluster

Check failure on line 41 in docs/civo/quick-start/install/marketplace.mdx

View workflow job for this annotation

GitHub Actions / markdown-check (.mdx, **.mdx, mdx.markdownlint.json)

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Create your kubefirst management cluster"]

docs/civo/quick-start/install/marketplace.mdx:41 MD022/blanks-around-headings/blanks-around-headers Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Create your kubefirst management cluster"]
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)

## 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.
4 changes: 2 additions & 2 deletions docs/civo/quick-start/install/ui.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
hide_title: true
sidebar_label: Console UI
sidebar_position: 1
sidebar_label: UI Installer
sidebar_position: 2
# custom_edit_url: https://github.com/facebook/docusaurus/edit/main/docs/api-doc-markdown.md
image: "https://docs.kubefirst.io/img/logo.svg"
---
Expand Down
Binary file added docs/img/civo/marketplace/create-management.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/civo/marketplace/installer-options.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 351ea04

Please sign in to comment.