Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: agent mode / deployment modes #4099

Merged
merged 42 commits into from
Oct 11, 2024
Merged

docs: agent mode / deployment modes #4099

merged 42 commits into from
Oct 11, 2024

Conversation

lennessyy
Copy link
Contributor

@lennessyy lennessyy commented Sep 26, 2024

Describe the Change

This PR documents deployment mods and procedure to deploy a cluster in agent mode

Changed Pages

💻 Deployment Modes

Jira Tickets

🎫 DOC-1398

Backports

Can this PR be backported?

  • No.

Copy link
Contributor

github-actions bot commented Sep 26, 2024

🤖 Netlify configured to enable preview build for branch: agent-mode . Subsequent commits will automatically trigger a Netlify build preview.

Copy link

netlify bot commented Sep 26, 2024

Deploy Preview for docs-spectrocloud ready!

Name Link
🔨 Latest commit 173a3bc
🔍 Latest deploy log https://app.netlify.com/sites/docs-spectrocloud/deploys/6709933ff536fc0008161a89
😎 Deploy Preview https://deploy-preview-4099--docs-spectrocloud.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@lennessyy lennessyy changed the title docs: start first page docs: agent mode / deployment modes Oct 1, 2024
lennessyy and others added 10 commits October 2, 2024 17:07
* docs: add agent installation guide

* docs: remove config ref paragraph

* docs: add agent mgmt page

* docs: add new controller mode page and diagram

* docs: add limitations, tech preview banner, fix command

* docs: vale feedback

* Optimised images with calibre/image-actions

* Apply suggestions from code review

* Optimised images with calibre/image-actions

---------

Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com>
Co-authored-by: Lenny Chen <[email protected]>
@lennessyy lennessyy marked this pull request as ready for review October 8, 2024 00:12
@lennessyy lennessyy requested a review from a team as a code owner October 8, 2024 00:12
Copy link
Contributor

@karl-cardenas-coding karl-cardenas-coding left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really solid start to this. The overview pages are great. I just have a few suggestions and questions.

docs/docs-content/deployment-modes/deployment-modes.md Outdated Show resolved Hide resolved
docs/docs-content/deployment-modes/deployment-modes.md Outdated Show resolved Hide resolved
docs/docs-content/deployment-modes/deployment-modes.md Outdated Show resolved Hide resolved
docs/docs-content/deployment-modes/controller-mode.md Outdated Show resolved Hide resolved
export USERDATA=./user-data
```

4. Download the Palette agent installation script. Access the [Agent Mode](https://github.com/spectrocloud/agent-mode)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We may be able to use this URL https://github.com/spectrocloud/agent-mode/releases/latest/download/palette-agent-install.sh and get away from versions all together.

Follow the Slack thread for more details 🧵

tags: ["edge"]
---

Palette offers the option to customize the Local UI web interface. You can change the color of the sidebar as well as
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe I'm missing something but outside of an EdgeForge context. How does a host become a localUI host? It's as simple as the host coming up, registering with Palette and accessing port 5080?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes. Local UI is enabled by default. Whether you register with Palette or not, as long as you didn't disable it in your user data, it's going to be available at port 5080.


The diagram below illustrates the agent mode cluster provisioning workflow.

![Architecture Diagram for Agent Mode](/deployment-modes_agent-mode.webp)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is great @lennessyy

@lennessyy lennessyy added backport-version-4-5 Backport changes to the version-4-5 branch. and removed backport-version-4-5 Backport changes to the version-4-5 branch. labels Oct 11, 2024
- [conntrack](https://conntrack-tools.netfilter.org/downloads.html). This requirement is specific for clusters that
use PXKE as the Kubernetes layer.
- (Airgap only) [Docker](https://www.docker.com/) is installed and available.
- (Airgap only) [Palette Edge CLI](../../spectro-downloads.md#palette-edge-cli) is installed and available.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[Vale.Terms] Use 'airgap' instead of 'Airgap'.

- [Rsync](https://github.com/RsyncProject/rsync)
- [conntrack](https://conntrack-tools.netfilter.org/downloads.html). This requirement is specific for clusters that
use PXKE as the Kubernetes layer.
- (Airgap only) [Crane](https://github.com/google/go-containerregistry/blob/main/cmd/crane/README.md) is installed and
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[Vale.Terms] Use 'airgap' instead of 'Airgap'.

@lennessyy lennessyy merged commit ced20b0 into release-4-5 Oct 11, 2024
14 checks passed
@lennessyy lennessyy deleted the agent-mode branch October 11, 2024 21:24
lennessyy added a commit that referenced this pull request Oct 13, 2024
* feat: release 4.5

* docs: DOC-1410 (#4121)

* docs: PLT-1407 (#4112)

* docs: PEM-5698 OIDC userinfo (#4119)

* docs: PEM-5698

* docs: vale feedback

* docs: missing commit

* docs: PCP-3569 Microk8s and Backup Failures (#4138)

* docs: PCP-3568

* docs: PCP-3569

* docs: fixed heading

* docs: Apply suggestions from code review

Co-authored-by: caroldelwing <[email protected]>

* ci: auto-formatting prettier issues

---------

Co-authored-by: caroldelwing <[email protected]>
Co-authored-by: karl-cardenas-coding <[email protected]>

* docs: PEM-5472 (#4181)

* docs: PEM-5472

* docs: trigger build

* docs: added limiation

* docs: apply suggestions from code review

* docs: capitalization fix

* docs: palette API docs - 4.5 (#4219)

* docs: update API

* chore: fix API labeler

* docs: PEM-6014 (#4216)

* docs: PEM-6014

* docs: more changes

* docs: added tooltip infobox

* docs: vale feedback

* Optimised images with calibre/image-actions

* Optimised images with calibre/image-actions

* docs: Apply suggestions from code review

Co-authored-by: caroldelwing <[email protected]>

* ci: auto-formatting prettier issues

---------

Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com>
Co-authored-by: caroldelwing <[email protected]>
Co-authored-by: karl-cardenas-coding <[email protected]>

* docs: add Edge api 4.5.0 (#4233)

* docs: add edge mgmt api 450

* ci: auto-formatting API changes

---------

Co-authored-by: Lenny Chen <[email protected]>
Co-authored-by: Karl Cardenas <[email protected]>
Co-authored-by: karl-cardenas-coding <[email protected]>

* docs: add workaround for RKE2 Cilium known issue (#4217)

* docs: add workaround

* docs:git statusgit status

* docs: add troubleshooting steps

* docs: vale

* docs: link upstream issue

* docs: add crosslink

---------

Co-authored-by: Lenny Chen <[email protected]>

* docs: add 4.5 palette oss licenses (#4251)

* docs: add 4.5 palette oss licenses

* docs: trigger netlify

* docs: disable webhook  (#4098)

* docs: start page

* docs: missing validate steps

* docs: add draft for webhook feature

* docs: add registry redirect instructions

* docs: copy edits

* docs: adjust verify steps

* docs: vale kubelet

* docs: address review comments

* docs: Update docs/docs-content/clusters/edge/edge-configuration/installer-reference.md

* chore: prettier

---------

Co-authored-by: Lenny Chen <[email protected]>
Co-authored-by: Karl Cardenas <[email protected]>
Co-authored-by: Karl Cardenas <[email protected]>

* docs: share local UI login (#4140)

* docs: add title description

* docs: add some steps"

* docs: add content to page

* docs: add note about getting edge host ID

* docs: add prereqs

* docs: add env variable tip

* docs: small copy edit

* docs: fix broken links

* docs: vale comments

* Apply suggestions from code review

Co-authored-by: Karl Cardenas <[email protected]>

* ci: auto-formatting prettier issues

* docs: address review comments

---------

Co-authored-by: Lenny Chen <[email protected]>
Co-authored-by: Karl Cardenas <[email protected]>
Co-authored-by: lennessyy <[email protected]>

* docs: DOC-1408 DOC-1472 PCP-3520 PE-5257 (#4159)

* docs: DOC-1408

* docs: more content

* docs: save

* chore: update content

* docs: more content

* docs: more content

* docs: update

* docs: PPD-1472

* docs: more changes

* docs: PCP-3567

* docs: updated terraform version

* docs: updates

* docs: PE-5257

* docs: PE-5257

* save

* docs: updated release notes

* docs: ready for review

* docs: apply suggestions from code review

Co-authored-by: caroldelwing <[email protected]>

* ci: auto-formatting prettier issues

---------

Co-authored-by: caroldelwing <[email protected]>
Co-authored-by: karl-cardenas-coding <[email protected]>

* docs: agent mode / deployment modes (#4099)

* docs: start first page

* docs: add category.json

* docs: rough outline

* docs: add more disposition and place holder text

* docs: add more placeholders

* docs: brief descriptions

* docs: add diagrams

* docs: convert to webp

* docs: index page draft

* docs: add agent mode content

* docs: add agent mode info

* docs: Agent Mode installation guide (#4198)

* docs: add agent installation guide

* docs: remove config ref paragraph

* docs: add agent mgmt page

* docs: add new controller mode page and diagram

* docs: add limitations, tech preview banner, fix command

* docs: vale feedback

* Optimised images with calibre/image-actions

* Apply suggestions from code review

* Optimised images with calibre/image-actions

---------

Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com>
Co-authored-by: Lenny Chen <[email protected]>

* docs: add appliance mode info

* docs: fix broken link

* docs: remove image from index page

* docs: add diagrams

* docs: add link to github repo, review prereqs

* docs: add local ui theming guide

* docs: update BYOS pack

* Optimised images with calibre/image-actions

* Optimised images with calibre/image-actions

* docs: add deployment modes icon

* docs: review grammar

* docs: add instructions for airgap

* docs: fix broken tab, add main diagram

* docs: replace gif bc it was not looping

* docs: comment out airgap

* docs: minor copy edit

* docs: add supported k8s distros

* docs: remove CPU model restrictions

* docs: add airgap steps

* Apply suggestions from code review

Co-authored-by: Karl Cardenas <[email protected]>

* docs: address review comments

* docs: add local ui link

* docs: address vale comments

* docs: fix grouptab, replace download script command

* docs: modify version number

* docs: change docker to crane

* docs: add warning for docker

* docs: add flannel limitation

---------

Co-authored-by: Lenny Chen <[email protected]>
Co-authored-by: Carolina Delwing Rosa <[email protected]>
Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com>
Co-authored-by: Karl Cardenas <[email protected]>

* chore: changes

* chore: added agent mode link

* chore: vale feedback

* docs: version.sh change (#4267)

* docs: version script

* docs: remove redundant changes

* docs: add robot.txt

* docs: rename robots.txt

---------

Co-authored-by: Lenny Chen <[email protected]>

* chore: version update

* chore: version changes

* docs: updated URLs

* chore: fix docs

---------

Co-authored-by: caroldelwing <[email protected]>
Co-authored-by: karl-cardenas-coding <[email protected]>
Co-authored-by: Ravikumar Kondepati <[email protected]>
Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com>
Co-authored-by: Lenny Chen <[email protected]>
Co-authored-by: Lenny Chen <[email protected]>
Co-authored-by: lennessyy <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants