SpectroCloud/RaspberryPiEdge

Raspberry Pi Edge Install

Install OS

# Connnect Network, Keyboard, HDMI, and Power
# Boot to Network by pressing and holding SHIFT

############################################################
# Raspberry Pi Device: RASPBERRY PI 5
# Operating System:    Ubuntu Server 24.04.2 LTS (64-BIT)
# Storage:             Internal SD CARD READER
############################################################

# Finish the Setup Wizard
# Modify Settings before completion
# -  Complete the Hostname
# -  Add a user and pass
# -  Enable SSH with password auth

Prepare Environment

##########################
# Download Edge Binaries #
##########################
# Location: RETOOL -> Palette Release -> Vertex Info -> Airgap Binaries -> edge-k3s -> <k8s_version>
# Location: RETOOL -> Airgap Binaries -> edge-native-byoi (latest)

#############################
## TRUST HomeLab CA CERTS  ##
#############################
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/AddTrustExternalCARoot.crt > /usr/local/share/ca-certificates/ders-star-ca.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/vmware-se/-/raw/main/HomeLab/DERS-CA-CERT/ders-ca.cer > /usr/local/share/ca-certificates/ders-ssca.crt
update-ca-certificates

###########################################
# Upload the Binaries into AirGapped Repo #
###########################################
# SET VARIABLES
export OCI_IMAGE_REGISTRY=harbor.dersllc.com
export OCI_IMAGE_BASE=airgap-spectro-images
export OCI_PACK_REGISTRY=harbor.dersllc.com
export OCI_PACK_BASE=airgap-spectro-packs
export K8S_VERSION="1.32.1"
export AGENT_VERSION="v4.6.12"

#############################
# Install Required Software #
#############################
sudo apt-get install jq zstd rsync conntrack docker.io -y
snap install oras --classic

oras login $OCI_IMAGE_REGISTRY --username 'admin' --password '<Password>'

docker login $OCI_IMAGE_REGISTRY -u admin -p '<Password>'

bash /nfs/Download/airgap-pack-edge-k3s-$K8S_VERSION.bin --target ./trash
export IMAGES=`cat ./trash/docker/images.lst | cut -d ',' -f 2`
for i in $IMAGES; \
do  \
  docker pull --platform arm64 $i; \
  docker tag $i $OCI_IMAGE_REGISTRY/$OCI_IMAGE_BASE/$i; \
  docker push --platform arm64 $OCI_IMAGE_REGISTRY/$OCI_IMAGE_BASE/$i; \
done
rm -rf ./trash
bash /nfs/Download/airgap-vertex-pack-edge-native-byoi-2.1.0.bin


###########################
# Sync the Repo in Vertex #
###########################
# Navigate to: https://paas.dersllc.com/admin/settings/registries/oci
# DER's Spectro-Packs -> sync

################################################
# Pull the arm64 agent and push to Airgap Repo #
################################################
docker pull --platform arm64 us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:$AGENT_VERSION
docker tag us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:$AGENT_VERSION $OCI_IMAGE_REGISTRY/$OCI_IMAGE_BASE/us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:$AGENT_VERSION
docker push --platform arm64 $OCI_IMAGE_REGISTRY/$OCI_IMAGE_BASE/us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:$AGENT_VERSION

###############################
# Enable Pause Agent Upgrades #
###############################
# Navigate to: edge-pi Project -> Project Settings -> Platform -> Platform Settings -> Pause Agent Upgrades

Install Palette Agent

##############################################################
# Export the Palette Stylus ARM Agent Container (Air-Gapped) #
##############################################################
# Note: The version needed can be found in RETOOL (Palette Release -> Vertex Info -> Components -> stylus)
docker pull  us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:v$AGENT_VERSION
docker save us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:v$AGENT_VERSION > arm-agent-$AGENT_VERSION.tar

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v$AGENT_VERSION/palette-agent-linux-arm64
curl --verbose --location $URL --output palette-agent
chmod +x palette-agent

#####################
# Install the Agent #
#####################
curl --insecure https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/edge/user-data.yaml > user-data
#./palette-agent install --source ./arm-agent-$AGENT_VERSION.tar  --config "./user-data" --local
./palette-agent install --source $OCI_IMAGE_REGISTRY/$OCI_IMAGE_BASE/us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:$AGENT_VERSION  --config "./user-data"

Create a Cluster Profile for the Edge Node

###########################
# Create New Edge Profile #
###########################
# Name: EDGE BASE RKE2
# Version: 1.31.4
# Type: Infrastructure
##
# Cloud Type: Edge Native
##
# OS Layer: BYOS Edge OS
# - Check the Preset radio button for edge
# - Values:
#   Add the following to the yaml
#     stylusPackage: harbor.dersllc.com/spectro-images/us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:v4.5.14
#     options:
#       system.uri: "NA"
# Add the following: 
# K8s Layer: Palette Optimized RKE2
# - Version: 1.31.4
# - Values: 
#   Modify all occurrences of docker.io with harbor.dersllc.com/spectro-images/docker.io
# Network Layer: Calico
# - Values: 
#   Modify all occurrences of us-docker.pkg.dev with harbor.dersllc.com/spectro-images/us-docker.pkg.dev

Create Cluster on Edge Node

################################### 
# Create Cluster on the Edge Node #
###################################
# Navigate to: Clusters -> Create Cluster
##
# Cluster Type: Edge Native
##
# Name: edge-pi
##
# Add Profile: EDGE BASE RKE2
##
# SSH Keys: opsman
# NTP Server: 172.16.84.21
# VIP: 172.16.84.35
##
# control-plane-pool configuration
# - Allow worker capability (Optional): TRUE
# - Architecture: arm64
# - Edge Hosts: edge-pi
# DELETE worker-pool configuration
##
# FINISH CONFIGURATION

Appendix

Troubleshooting

Error:

time="2025-04-11T16:25:35Z" level=error msg="system image is not defined cannot apply upgrade" version=v4.6.12

Fix:

export VERTEX_ENDPOINT="paas.dersllc.com"
export IMG_HOST_ENDPOINT="us-docker.pkg.dev/palette-images/edge"
export STYLUS_IMG_ENDPOINT="harbor.dersllc.com/airgap-spectro-images/us-docker.pkg.dev/palette-images-fips/edge"

export AUTH_TOKEN=`curl --insecure -X POST -H "Content-Type: application/json" -d '{"username":"admin","password":"<password>"}' https://api.$VERTEX_ENDPOINT/v1/auth/syslogin | jq -r '.Authorization'`
#echo $AUTH_TOKEN
echo "curl --insecure -X GET -H 'Authorization: $AUTH_TOKEN'  https://api.$VERTEX_ENDPOINT/v1/system/config/edgeNative/image" | bash -
echo "curl --insecure -X PUT -H 'Authorization: $AUTH_TOKEN' -H 'Content-Type: application/json' -d '{\"spec\":{\"imagesHostEndpoint\":\"$IMG_HOST_ENDPOINT\",\"stylusImagesEndpoint\":\"$STYLUS_IMG_ENDPOINT\"}}' https://api.$VERTEX_ENDPOINT/v1/system/config/edgeNative/image" | bash -