Agent Mode

Prerequisites

Before you begin, ensure you have the following installed:

• bash
• systemd
• rsync
• jq
• zstd
• conntrack (required for PXKE clusters)
• systemd-networkd (required if palette is managing networks)
• systemd-resolved (required if palette is managing DNS)
• systemd-timesyncd (required if palette is managing NTP)
• rsyslog (required for audit logs)
• nfs-common (required for zot) in Ubuntu. Equivalent packages for other OS - nfs-utils for RHEL, nfs-client for Opensuse

To enable FIPS modules on Ubuntu - refer to the documentation here

To enable FIPS mode of RHEL - refer to the documentation here

Refer to respective Operating system documentation for enabling FIPS mode.

Quick Start

To quickly install the agent, run the following command:

curl -Ls https://github.com/spectrocloud/agent-mode/releases/latest/download/palette-agent-install.sh | bash

Usage

Specify Userdata

Userdata can be a URL or a file path.

curl -Ls https://github.com/spectrocloud/agent-mode/releases/latest/download/palette-agent-install.sh | USERDATA=https://xxx/userdata bash
# or
curl -Ls https://github.com/spectrocloud/agent-mode/releases/latest/download/palette-agent-install.sh | USERDATA=/path/to/userdata bash

Specify Palette version

curl -Ls https://github.com/spectrocloud/agent-mode/releases/latest/download/palette-agent-install.sh | VERSION=v4.5.0 bash

FIPS(Work In Progress)

curl -Ls https://github.com/spectrocloud/agent-mode/releases/latest/download/palette-agent-install-fips.sh | bash

Userdata

Refer to Palette Agent Parameters Documentation for more details.

Examples

Here are some examples of how to use the install script on different platforms.

• MAAS
• Lima

Development

Build install script

earthly +install-script \
    --IMAGE_REPO=us-docker.pkg.dev/palette-images/edge \
    --AGENT_URL_PREFIX=https://github.com/spectrocloud/agent-mode/releases/download/v4.5.0-rc5 \
    --PE_VERSION=v4.5.0-rc7