DER's LLC - User contributions [en]

SpectroCloud

2025-06-17T15:07:55Z

Ders:

[[SpectroCloud/VertexInstall | Vertex Installation Instructions]] 
[[SpectroCloud/VertexISOInstall | Vertex ISO Installation Instructions]] 
[[SpectroCloud/VertexHelmInstall | Vertex Helm Installation Instructions]] 
[[SpectroCloud/VertexUpgrade | Vertex Upgrade Instructions]] 
[[SpectroCloud/VertexLabConfig | Vertex Lab Configuration]] 
[[SpectroCloud/MAAS | MAAS Information]] 
[[SpectroCloud/RaspberryPiEdgePrep | RaspberryPi Edge Prep]] 

[[SpectroCloud/PaletteBackup | Palette Backup Script]]

VMware/Jumpbox

2025-05-01T16:36:15Z

Ders: /* Jumpbox Setup */

=Jumpbox Setup=

https://ders-gitlab.dersllc.com/ders/ders-home-lab/-/blob/main/jumpbox/README.md

==OS==
Ubuntu 24.04 UEFI

IP: edit the /etc/netplan/50-cloud-init.yaml
REBOOT

==Software==
#######################
## INSTALL TANZU CLI ##
#######################
sudo mkdir -p /etc/apt/keyrings/
sudo apt-get update -y
sudo apt-get install -y ca-certificates curl gpg
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt-get update
sudo apt-get install -y tanzu-cli

###################
## INSTALL SNAPD ##
###################
apt-get -y install snapd unzip nfs-common ca-certificates

###########################
## INSTALL Snap Software ##
###########################
snap install yq
snap install k9s
ln -s /snap/k9s/current/bin/k9s /usr/local/bin/k9s

#################################
## INSTALL KUBECTL-VSPHERE CLI ##
#################################
wget --no-check-certificate https://tkgs.dersllc.com/wcp/plugin/linux-amd64/vsphere-plugin.zip
unzip vsphere-plugin.zip
mv bin/* /usr/local/bin/
chmod +x /usr/local/bin/*
rm -rf ./bin vsphere-plugin.zip

############################
## LOGIN TO TKGS CLUSTERS ##
############################
kubectl-vsphere login --insecure-skip-tls-verify -u admin --server tkgs.dersllc.com --tanzu-kubernetes-cluster-namespace tmc --tanzu-kubernetes-cluster-name hub
kubectl-vsphere login --insecure-skip-tls-verify -u admin --server tkgs.dersllc.com --tanzu-kubernetes-cluster-namespace tmc --tanzu-kubernetes-cluster-name tmc-cluster
kubectl-vsphere login --insecure-skip-tls-verify -u admin --server tkgs.dersllc.com --tanzu-kubernetes-cluster-namespace ders --tanzu-kubernetes-cluster-name ders-cluster
kubectl-vsphere login --insecure-skip-tls-verify -u admin --server tkgs.dersllc.com --tanzu-kubernetes-cluster-namespace ders --tanzu-kubernetes-cluster-name tap

#####################
## SETUP TANZU CLI ##
#####################
tanzu init
tanzu plugin group get vmware-tkg/default:v2.5.1
tanzu plugin install --group vmware-tkg/default:v2.5.1
tanzu context create tkgs.dersllc.com --kubeconfig ~/.kube/config --kubecontext tkgs.dersllc.com
tanzu cluster list -A
tanzu plugin install --group vmware-tmc/default
tanzu plugin install --group vmware-tap/default

######################
## SETUP NFS MOUNTS ##
######################
mkdir -p /nfs/QNAP/Plex /nfs/appStore /nfs/Download /nfs/Web /nfs/Apps /nfs/DERs_Drive
echo "#DERS NFS MOUNTS" >> /etc/fstab
echo "172.16.85.15:/Plex /nfs/QNAP/Plex nfs vers=4.0 0 0" >> /etc/fstab
echo "172.16.85.15:/Apps /nfs/Apps nfs vers=4.0 0 0" >> /etc/fstab
echo "172.16.85.15:/DERs_Drive /nfs/DERs_Drive nfs vers=4.0 0 0" >> /etc/fstab
echo "172.16.85.15:/Web /nfs/Web nfs vers=4.0 0 0" >> /etc/fstab
echo "172.16.85.15:/Download /nfs/Download nfs vers=4.0 0 0" >> /etc/fstab
mount -a

#########################
## TRUST DERS CA CERTS ##
#########################
sudo curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/AddTrustExternalCARoot.crt > /usr/local/share/ca-certificates/ders-star-ca.crt
sudo 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
sudo update-ca-certificates

SpectroCloud/Packs

2025-04-25T13:34:37Z

Ders: /* Build and Push Pack */

=Packs=

=== PreRequisites ===
snap install oras --classic
oras login harbor.dersllc.com --username 'admin' --password '<Password>'

=== Clone Pack Version and Commit to GIT ===
export PACK_NAME='mediacms'
export OLD_PACK_VERSION='4.3.0-8'
export NEW_PACK_VERSION='4.6.0'
git clone https://ders-gitlab.dersllc.com/ders/spectro-sa.git
cd spectro-sa/packs/
cp -r $PACK_NAME-$OLD_PACK_VERSION $PACK_NAME-$NEW_PACK_VERSION
sed -i 's/'$OLD_PACK_VERSION'/'$NEW_PACK_VERSION'/' $PACK_NAME-$NEW_PACK_VERSION/pack.json
git add *
git commit -m "Added version $PACK_NAME-$NEW_PACK_VERSION"
git push

cd ../..
rm -rf spectro-sa/

=== Build and Push Pack ===
export PACK_NAME='mediacms'
export PACK_VERSION='4.6.0'
git clone https://ders-gitlab.dersllc.com/ders/spectro-sa.git
cd spectro-sa/packs/
tar -zcvf $PACK_NAME-$PACK_VERSION.tar.gz $PACK_NAME-$PACK_VERSION/
oras push harbor.dersllc.com/ders-packs/spectro-packs/archive/$PACK_NAME:$PACK_VERSION $PACK_NAME-$PACK_VERSION.tar.gz --insecure --annotation org.opencontainers.image.created="2023-07-24T11:57:56Z"
cd ../..
rm -rf spectro-sa/

== Sync the Repo ==
https://vertex.dersllc.com/system/administration/registries/pack

== Resources ==
https://github.com/spectrocloud/pack-central/tree/main/packs

SpectroCloud/Packs

2025-04-25T13:34:29Z

Ders: /* Clone Pack Version and Commit to GIT */

=Packs=

=== PreRequisites ===
snap install oras --classic
oras login harbor.dersllc.com --username 'admin' --password '<Password>'

=== Clone Pack Version and Commit to GIT ===
export PACK_NAME='mediacms'
export OLD_PACK_VERSION='4.3.0-8'
export NEW_PACK_VERSION='4.6.0'
git clone https://ders-gitlab.dersllc.com/ders/spectro-sa.git
cd spectro-sa/packs/
cp -r $PACK_NAME-$OLD_PACK_VERSION $PACK_NAME-$NEW_PACK_VERSION
sed -i 's/'$OLD_PACK_VERSION'/'$NEW_PACK_VERSION'/' $PACK_NAME-$NEW_PACK_VERSION/pack.json
git add *
git commit -m "Added version $PACK_NAME-$NEW_PACK_VERSION"
git push

cd ../..
rm -rf spectro-sa/

=== Build and Push Pack ===
export PACK_NAME='mediacms'
export PACK_VERSION='4.3.0-8'
git clone https://ders-gitlab.dersllc.com/ders/spectro-sa.git
cd spectro-sa/packs/
tar -zcvf $PACK_NAME-$PACK_VERSION.tar.gz $PACK_NAME-$PACK_VERSION/
oras push harbor.dersllc.com/ders-packs/spectro-packs/archive/$PACK_NAME:$PACK_VERSION $PACK_NAME-$PACK_VERSION.tar.gz --insecure --annotation org.opencontainers.image.created="2023-07-24T11:57:56Z"
cd ../..
rm -rf spectro-sa/

== Sync the Repo ==
https://vertex.dersllc.com/system/administration/registries/pack

== Resources ==
https://github.com/spectrocloud/pack-central/tree/main/packs

SpectroCloud/Packs

2025-04-23T13:39:11Z

Ders: /* Build and Push Pack */

=Packs=

=== PreRequisites ===
snap install oras --classic
oras login harbor.dersllc.com --username 'admin' --password '<Password>'

=== Clone Pack Version and Commit to GIT ===
export PACK_NAME='mediacms'
export OLD_PACK_VERSION='4.3.0-7'
export NEW_PACK_VERSION='4.3.0-8'
git clone https://ders-gitlab.dersllc.com/ders/spectro-sa.git
cd spectro-sa/packs/
cp -r $PACK_NAME-$OLD_PACK_VERSION $PACK_NAME-$NEW_PACK_VERSION
sed -i 's/'$OLD_PACK_VERSION'/'$NEW_PACK_VERSION'/' $PACK_NAME-$NEW_PACK_VERSION/pack.json
git add *
git commit -m "Added version $PACK_NAME-$NEW_PACK_VERSION"
git push

cd ../..
rm -rf spectro-sa/

=== Build and Push Pack ===
export PACK_NAME='mediacms'
export PACK_VERSION='4.3.0-8'
git clone https://ders-gitlab.dersllc.com/ders/spectro-sa.git
cd spectro-sa/packs/
tar -zcvf $PACK_NAME-$PACK_VERSION.tar.gz $PACK_NAME-$PACK_VERSION/
oras push harbor.dersllc.com/ders-packs/spectro-packs/archive/$PACK_NAME:$PACK_VERSION $PACK_NAME-$PACK_VERSION.tar.gz --insecure --annotation org.opencontainers.image.created="2023-07-24T11:57:56Z"
cd ../..
rm -rf spectro-sa/

== Sync the Repo ==
https://vertex.dersllc.com/system/administration/registries/pack

== Resources ==
https://github.com/spectrocloud/pack-central/tree/main/packs

SpectroCloud/Packs

2025-04-22T13:33:51Z

Ders: /* Build and Push Pack */

=Packs=

=== PreRequisites ===
snap install oras --classic
oras login harbor.dersllc.com --username 'admin' --password '<Password>'

=== Clone Pack Version and Commit to GIT ===
export PACK_NAME='mediacms'
export OLD_PACK_VERSION='4.3.0-7'
export NEW_PACK_VERSION='4.3.0-8'
git clone https://ders-gitlab.dersllc.com/ders/spectro-sa.git
cd spectro-sa/packs/
cp -r $PACK_NAME-$OLD_PACK_VERSION $PACK_NAME-$NEW_PACK_VERSION
sed -i 's/'$OLD_PACK_VERSION'/'$NEW_PACK_VERSION'/' $PACK_NAME-$NEW_PACK_VERSION/pack.json
git add *
git commit -m "Added version $PACK_NAME-$NEW_PACK_VERSION"
git push

cd ../..
rm -rf spectro-sa/

=== Build and Push Pack ===
export PACK_NAME='mediacms'
export PACK_VERSION='4.3.0-8'
git clone https://ders-gitlab.dersllc.com/ders/spectro-sa.git
cd spectro-sa/packs/
tar -zcvf $PACK_NAME-$PACK_VERSION.tar.gz $PACK_NAME-$PACK_VERSION/
oras push harbor.dersllc.com/ders-packs/archive/$PACK_NAME:$PACK_VERSION $PACK_NAME-$PACK_VERSION.tar.gz --insecure --annotation org.opencontainers.image.created="2023-07-24T11:57:56Z"
cd ../..
rm -rf spectro-sa/

== Sync the Repo ==
https://vertex.dersllc.com/system/administration/registries/pack

== Resources ==
https://github.com/spectrocloud/pack-central/tree/main/packs

SpectroCloud/AirGapEdgeISO

2025-04-18T12:55:07Z

Ders:

= Air-Gapped Edge ISO =
https://ders-gitlab.dersllc.com/ders/spectro-sa/-/wikis/Airgapped-Edge-All-In-One-ISO
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq '.spec | select(.version=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .published.uid`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq '.spec | select(.version=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .published.packs[1].version`

#echo PROJECT_UID:$PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K8S_VERSION:$K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
# Pull the earthly image and retag so it does not re-pull everytime!
docker pull us-docker.pkg.dev/palette-images/third-party/edge/earthly/earthly:v0.8.15
docker tag us-docker.pkg.dev/palette-images/third-party/edge/earthly/earthly:v0.8.15 us-docker.pkg.dev/palette-images/third-party/edge/earthly/earthly:keep
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T17:37:49Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq '.spec | select(.version=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .published.uid`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq '.spec | select(.version=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .published.packs[1].version`

#echo PROJECT_UID:$PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K8S_VERSION:$K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
# Pull the earthly image and retag so it does not re-pull everytime!
docker pull us-docker.pkg.dev/palette-images/third-party/edge/earthly/earthly:v0.8.15
docker tag us-docker.pkg.dev/palette-images/third-party/edge/earthly/earthly:v0.8.15 us-docker.pkg.dev/palette-images/third-party/edge/earthly/earthly:keep
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T17:33:24Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq '.spec | select(.version=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .published.uid`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq '.spec | select(.version=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .published.packs[1].version`

#echo PROJECT_UID:$PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K8S_VERSION:$K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T17:33:09Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq '.spec | select(.version=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .published.uid`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/j
son" | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq '.spec | select(.version=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .published.packs[1].version`

#echo PROJECT_UID:$PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K8S_VERSION:$K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T17:15:25Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","order":"desc"}]}' | jq '.items[]' | jq -r '.metadata.uid'`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","order":"desc"}]}' | jq '.items[]' | jq -r .specSummary.published.packs[1].tag`

#echo PROJECT_UID:$PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K8S_VERSION:$K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T17:13:48Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","order":"desc"}]}' | jq '.items[]' | jq -r '.metadata.uid'`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","order":"desc"}]}' | jq '.items[]' | jq -r .specSummary.published.packs[1].tag`

#echo PROJECT_UID: $PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K8S_VERSION: $K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T17:12:36Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","order":"desc"}]}' | jq '.items[]' | jq -r '.metadata.uid'`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: application/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","order":"desc"}]}' | jq '.items[]' | jq -r .specSummary.published.packs[1].tag`

#echo PROJECT_UID:$PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K*S_VERSION:$K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T17:12:04Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: app
lication/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","order":"desc"}]}' | jq '.items[]' | jq -r '.metadata.uid'`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: app
lication/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","or
der":"desc"}]}' | jq '.items[]' | jq -r .specSummary.published.packs[1].tag`

#echo PROJECT_UID:$PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K*S_VERSION:$K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T17:01:01Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: app
lication/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","or
der":"desc"}]}' | jq '.items[]' | jq -r '.metadata.uid'`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/dashboard/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY -H 'Projectuid: '${PROJECT_UID} -H "Content-Type: app
lication/json" -d '{"filter":{"environment":[],"profileName":{"contains":"'${CLUSTER_PROFILE_NAME}'"},"profileType":["cluster","infra","add-on"]},"sort":[{"field":"lastModifiedTimestamp","or
der":"desc"}]}' | jq '.items[]' | jq -r .specSummary.published.packs[1].tag`

#echo PROJECT_UID:$PROJECT_UID; echo CLUSTER_PROFILE_ID:$CLUSTER_PROFILE_UID; echo K*S_VERSION:$K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T16:50:26Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
#OLD: export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq -r .metadata.uid`
#OLD export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq -r .spec.published.packs[1].tag`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.spec.published.name=="'${CLUSTER_PROFILE_NAME}'") | select(.spec.published.profileVersion=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .spec.published.uid`
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROJECT_NAME}'")' | jq -r .metadata.uid`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'") | select(.spec.published.profileVersion=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .spec.published.packs[1].tag`
#echo $CLUSTER_PROFILE_UID; echo $PROJECT_UID; echo $K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T16:49:10Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROJECT_NAME="all-in-one-iso";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
#OLD: export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq -r .metadata.uid`
#OLD export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq -r .spec.published.packs[1].tag`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.spec.published.name=="'${CLUSTER_PROFILE_NAME}'") | select(.spec.published.profileVersion=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .spec.published.uid`
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROFILE_NAME}'")' | jq -r .metadata.uid`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'") | select(.spec.published.profileVersion=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .spec.published.packs[1].tag`
#echo $CLUSTER_PROFILE_UID; echo $PROJECT_UID; echo $K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T16:27:25Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROFILE_NAME="Default";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
#export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
#OLD: export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq -r .metadata.uid`
#OLD export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq -r .spec.published.packs[1].tag`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.spec.published.name=="'${CLUSTER_PROFILE_NAME}'") | select(.spec.published.profileVersion=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .spec.published.uid`
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROFILE_NAME}'")' | jq -r .metadata.uid`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'") | select(.spec.published.profileVersion=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .spec.published.packs[1].tag`
#echo $CLUSTER_PROFILE_UID; echo $PROJECT_UID; echo $K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/AirGapEdgeISO

2025-04-17T16:26:40Z

Ders: /* Build the All-In-One ISO File */

= Air-Gapped Edge ISO =
== Prerequisites==
=== DER's Lab Specific ===
#######################################
# Build the ISO on the JUMPBOX Server #
#######################################
ssh ders@172.16.84.34
sudo su -

##############################
# Mount the VMware Datastore #
##############################
echo "172.16.84.7:/data/hdd/0-ISOs /nfs/0-ISOs nfs defaults 0 0" >> /etc/fstab
cat /etc/fstab
mkdir -p /nfs/0-ISOs
systemctl daemon-reload
mount -a

=== ISO Build Requirements ===
##############################################
# Create Harbor Repo for the provider images #
##############################################
# Name: airgap-edge
# Type: public

#################################################################
# Update the .args file and BYOI Layer with the Following Info: #
#################################################################
# BYOI VALUES:
options:
system.uri: <nowiki>"{{ .spectro.pack.edge-native-byoi.options.system.registry }}/{{ .spectro.pack.edge-native-byoi.options.system.repo }}:{{ .spectro.pack.edge-native-byoi.options.system.k8sDistribution }}-{{.spectro.system.kubernetes.version }}-{{ .spectro.pack.edge-native-byoi.options.system.peVersion }}-{{ .spectro.pack.edge-native-byoi.options.system.customTag }}"</nowiki>
system.registry: harbor.dersllc.com/airgap-edge
system.repo: ubuntu
system.k8sDistribution: kubeadm
system.osName: ubuntu
system.peVersion: v4.6.3
system.customTag: ders-edge
system.osVersion: 22.04
#
# .ARG FILE:
# CUSTOM_TAG=ders-edge
# IMAGE_REGISTRY=harbor.dersllc.com/airgap-edge
# OS_DISTRIBUTION=ubuntu
# IMAGE_REPO=$OS_DISTRIBUTION
# OS_VERSION=22.04
# K8S_DISTRIBUTION=kubeadm
# ISO_NAME=ders-edge-installer
# ARCH=amd64
# UPDATE_KERNEL=false
# CLUSTERCONFIG=test-edge-iso-profile-cluster-definition.tgz
# CIS_HARDENING=true
# BASE_IMAGE=quay.io/kairos/ubuntu:24.04-core-amd64-generic-v3.0.14

# CHANGE THE FOLLOWING IN THE K8S LAYER
# REMOVE: AlwaysPullImages
# MAKE SURE YOU HAVE THE HARBOR-EDGE-NATIVE-CONFIG LAYER ADDED TO THE PROFILE

== Build the All-In-One ISO File ==
######################
# REQUIRED VARIABLES #
######################
export OS=ubuntu-fips; #rhel, rhel-fips, ubuntu, ubuntu-fips
export PALETTE_ENDPOINT="paas.dersllc.com";
export API_KEY='Y2ZiYWZkNWRmN2E0YjAzYTFjYjYyOTBhMjk3YjZlMDg=';
export CLUSTER_PROFILE_NAME="test-edge-iso-$OS"
export CLUSTER_PROFILE_VERSION=1.0.2
export PROFILE_NAME="Default";
export EDGE_CLI_VERSION="v4.6.9"; #https://docs.spectrocloud.com/component/#palette-edge-cli-versions

#################################
# Download the Palette-Edge CLI #
#################################
wget https://software.spectrocloud.com/stylus/$EDGE_CLI_VERSION/cli/linux/palette-edge
chmod +x palette-edge
mv palette-edge /usr/local/bin
cd ~; rm -rf CanvOS

###################################
# Use GIT to pull the CanvOS Repo #
###################################
git clone https://github.com/spectrocloud/CanvOS.git
cd CanvOS
# export EDGE_CLI_VERSION=`git tag | sort --version-sort | tail -1`
git checkout $EDGE_CLI_VERSION

################################################
# Pull the .arg and user-data file from gitlab #
################################################
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/.arg-$OS.yaml > .arg
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/user-data-$OS.yaml > user-data
#sudo ./earthly.sh +validate-user-data

###############################################################################
# Get the Project and Cluster Profile IDs and K8S Version from the VERTEX API #
###############################################################################
#OLD: export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq -r .metadata.uid`
#OLD export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'")' | jq -r .spec.published.packs[1].tag`
export CLUSTER_PROFILE_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.spec.published.name=="'${CLUSTER_PROFILE_NAME}'") | select(.spec.published.profileVersion=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .spec.published.uid`
export PROJECT_UID=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/projects' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${PROFILE_NAME}'")' | jq -r .metadata.uid`
export K8S_VERSION=`curl -L 'https://'${PALETTE_ENDPOINT}'/v1/clusterprofiles' -H 'Accept: application/json' -H 'ApiKey: '$API_KEY | jq '.items[] | select(.metadata.name=="'${CLUSTER_PROFILE_NAME}'") | select(.spec.published.profileVersion=="'${CLUSTER_PROFILE_VERSION}'")' | jq -r .spec.published.packs[1].tag`
#echo $CLUSTER_PROFILE_UID; echo $PROJECT_UID; echo $K8S_VERSION;

#####################################
# Pull Variables from the .arg File #
#####################################
export CUSTOM_TAG=`cat .arg | grep CUSTOM_TAG | cut -d "=" -f 2`
export IMAGE_REGISTRY=`cat .arg | grep IMAGE_REGISTRY | cut -d "=" -f 2`
export OS_DISTRIBUTION=`cat .arg | grep OS_DISTRIBUTION | cut -d "=" -f 2`
export OS_VERSION=`cat .arg | grep OS_VERSION | cut -d "=" -f 2`
export K8S_DISTRIBUTION=`cat .arg | grep K8S_DISTRIBUTION | cut -d "=" -f 2`
export ISO_NAME=`cat .arg | grep ISO_NAME | cut -d "=" -f 2`
#echo $CUSTOM_TAG; echo $IMAGE_REGISTRY; echo $OS_DISTRIBUTION; echo $OS_VERSION; echo $K8S_DISTRIBUTION; echo $ISO_NAME

echo '{"'$K8S_DISTRIBUTION'":["'$K8S_VERSION'"]}' | jq > k8s_version.json; # Set only the version you need in the k8s_version.json. This needs to match the version in your profile.
#cat k8s_version.json

#########################################
# Customize the Local-Ui (Not-Required) #
#########################################
mkdir -p local-ui/ui
mkdir -p local-ui/app
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/customizations.json > local-ui/ui/customizations.json
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/index.html > local-ui/app/index.html
curl https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/airgapped-edge/customizations/154x65.png > local-ui/ui/154x65.png
tar cvf local-ui.tar local-ui

#############################
# Build the Provider Images #
#############################
#sudo ./earthly.sh +build-provider-images
sudo ./earthly.sh +build-provider-images-fips

#############################################
# Push the Provider image to the Image Repo #
#############################################
docker push $IMAGE_REGISTRY/$OS_DISTRIBUTION:$K8S_DISTRIBUTION-$K8S_VERSION-$EDGE_CLI_VERSION-$CUSTOM_TAG

###########################################################
# Export the Vertex Profile Definition and Content Bundle #
###########################################################
palette-edge build --api-key $API_KEY \
--project-id $PROJECT_UID \
--cluster-profile-ids $CLUSTER_PROFILE_UID \
--palette-endpoint $PALETTE_ENDPOINT \
--outfile $CLUSTER_PROFILE_NAME-content-bundle \
--include-palette-content \
--cluster-definition-name $CLUSTER_PROFILE_NAME-cluster-definition \
--cluster-definition-profile-ids $CLUSTER_PROFILE_UID

############################
# Build the All-In-One ISO #
############################
sudo ./earthly.sh +iso

#######################################
# Move the ISO to my VMware Datastore #
#######################################
touch ~/CanvOS/build/$ISO_NAME.iso
mv ~/CanvOS/build/$ISO_NAME.iso /nfs/0-ISOs/

== References ==
=== Building Provider Images ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images/
=== Build Content Bundle ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle/
=== Create Installer ISO ===
https://docs.spectrocloud.com/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso/
=== Local-UI Custom Branding ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/theming/
=== Local-UI Custom Links ===
https://docs.spectrocloud.com/clusters/edge/local-ui/host-management/custom-link/

SpectroCloud/PaletteBackup

2025-04-15T13:10:12Z

Ders: /* Common Options */

= Palette Backup and Restore Tool =

This tool provides full API-based backup and restore capabilities for a self-hosted SpectroCloud Palette instance.

== Features ==
* Backup and restore via **Palette API**
* Supports local user login or API token authentication
* Backup includes:
- Tenants
- Projects
- Users (with optional redaction)
- Roles
- SSH Keys
- Cloud Accounts
- Cluster Profiles
- Git Repositories
- Blueprints
- Clusters (metadata)
- Marketplace Items
* Fine-grained control via `--only`
* Auto-cleanup of old backups via `--max-backups`
* Intelligent restore ordering
* Interactive fallback if flags are omitted

== Requirements ==
* Python 3.8+
* `httpx`
* Access to a running Palette API (e.g., `https://paas.dersllc.com`)

== Installation ==
pip install httpx

== Usage ==

=== Backup ===
python palette-backup.py --mode=backup \
--endpoint=https://paas.dersllc.com \
--directory=/mnt/backups \
--max-backups=5 \
--redact

=== Restore ===
python palette-backup.py --mode=restore \
--endpoint=https://paas.dersllc.com \
--directory=/mnt/backups \
--backup=2025-04-15_03-00 \
--force

=== Common Options ===
| Flag | Description |
|-----------------------------|----------------------------------------------|
| `--mode` | `backup` or `restore` (required) |
| `--endpoint` | Palette API base URL |
| `--directory` | Backup root path |
| `--backup` | Subfolder (timestamp) to restore from |
| `--only` | Comma-separated list of resource types |
| `--force` | Overwrite existing objects |
| `--max-backups` | Max folders to keep (backup mode only) |
| `--redact` | Remove sensitive fields (users) |
| `--username` / `--password` | Login credentials (prompted if not provided) |
| `--api-key` | Token auth (bypasses login) |

=== Supported Resource Types ===
- `tenants`
- `projects`
- `users`
- `roles`
- `keys`
- `cloud`
- `profiles`
- `repos`
- `blueprints`
- `clusters`
- `marketplace`

== Notes ==
* Redacted backups will exclude passwords and tokens from user records.
* Restore operations skip existing resources unless `--force` is used.
* Resource creation order is dependency-aware (e.g., tenants → projects → users).

== License ==
MIT or internal use.

== Maintainer ==
Daniel Roessner

SpectroCloud/PaletteBackup

2025-04-15T13:10:01Z

Ders: /* Common Options */

= Palette Backup and Restore Tool =

This tool provides full API-based backup and restore capabilities for a self-hosted SpectroCloud Palette instance.

== Features ==
* Backup and restore via **Palette API**
* Supports local user login or API token authentication
* Backup includes:
- Tenants
- Projects
- Users (with optional redaction)
- Roles
- SSH Keys
- Cloud Accounts
- Cluster Profiles
- Git Repositories
- Blueprints
- Clusters (metadata)
- Marketplace Items
* Fine-grained control via `--only`
* Auto-cleanup of old backups via `--max-backups`
* Intelligent restore ordering
* Interactive fallback if flags are omitted

== Requirements ==
* Python 3.8+
* `httpx`
* Access to a running Palette API (e.g., `https://paas.dersllc.com`)

== Installation ==
pip install httpx

== Usage ==

=== Backup ===
python palette-backup.py --mode=backup \
--endpoint=https://paas.dersllc.com \
--directory=/mnt/backups \
--max-backups=5 \
--redact

=== Restore ===
python palette-backup.py --mode=restore \
--endpoint=https://paas.dersllc.com \
--directory=/mnt/backups \
--backup=2025-04-15_03-00 \
--force

=== Common Options ===
| Flag | Description |
|-----------------------------|----------------------------------------------|
| `--mode` | `backup` or `restore` (required) |
| `--endpoint` | Palette API base URL |
| `--directory` | Backup root path |
| `--backup` | Subfolder (timestamp) to restore from |
| `--only` | Comma-separated list of resource types |
| `--force` | Overwrite existing objects |
| `--max-backups` | Max folders to keep (backup mode only) |
| `--redact` | Remove sensitive fields (users) |
| `--username` / `--password` | Login credentials (prompted if not provided) |
| `--api-key` | Token auth (bypasses login) |
|-----------------------------|----------------------------------------------|

=== Supported Resource Types ===
- `tenants`
- `projects`
- `users`
- `roles`
- `keys`
- `cloud`
- `profiles`
- `repos`
- `blueprints`
- `clusters`
- `marketplace`

== Notes ==
* Redacted backups will exclude passwords and tokens from user records.
* Restore operations skip existing resources unless `--force` is used.
* Resource creation order is dependency-aware (e.g., tenants → projects → users).

== License ==
MIT or internal use.

== Maintainer ==
Daniel Roessner

SpectroCloud/PaletteBackup

2025-04-15T13:07:01Z

Ders: Created page with "= Palette Backup and Restore Tool = This tool provides full API-based backup and restore capabilities for a self-hosted SpectroCloud Palette instance. == Features == * Backup and restore via **Palette API** * Supports local user login or API token authentication * Backup includes: - Tenants - Projects - Users (with optional redaction) - Roles - SSH Keys - Cloud Accounts - Cluster Profiles - Git Repositories - Blueprints - Clusters (metadata) - Mar..."

= Palette Backup and Restore Tool =

This tool provides full API-based backup and restore capabilities for a self-hosted SpectroCloud Palette instance.

== Features ==
* Backup and restore via **Palette API**
* Supports local user login or API token authentication
* Backup includes:
- Tenants
- Projects
- Users (with optional redaction)
- Roles
- SSH Keys
- Cloud Accounts
- Cluster Profiles
- Git Repositories
- Blueprints
- Clusters (metadata)
- Marketplace Items
* Fine-grained control via `--only`
* Auto-cleanup of old backups via `--max-backups`
* Intelligent restore ordering
* Interactive fallback if flags are omitted

== Requirements ==
* Python 3.8+
* `httpx`
* Access to a running Palette API (e.g., `https://paas.dersllc.com`)

== Installation ==
pip install httpx

== Usage ==

=== Backup ===
python palette-backup.py --mode=backup \
--endpoint=https://paas.dersllc.com \
--directory=/mnt/backups \
--max-backups=5 \
--redact

=== Restore ===
python palette-backup.py --mode=restore \
--endpoint=https://paas.dersllc.com \
--directory=/mnt/backups \
--backup=2025-04-15_03-00 \
--force

=== Common Options ===
| Flag | Description |
|-------------------|-------------|
| `--mode` | `backup` or `restore` (required) |
| `--endpoint` | Palette API base URL |
| `--directory` | Backup root path |
| `--backup` | Subfolder (timestamp) to restore from |
| `--only` | Comma-separated list of resource types |
| `--force` | Overwrite existing objects |
| `--max-backups` | Max folders to keep (backup mode only) |
| `--redact` | Remove sensitive fields (users) |
| `--username` / `--password` | Login credentials (prompted if not provided) |
| `--api-key` | Token auth (bypasses login) |

=== Supported Resource Types ===
- `tenants`
- `projects`
- `users`
- `roles`
- `keys`
- `cloud`
- `profiles`
- `repos`
- `blueprints`
- `clusters`
- `marketplace`

== Notes ==
* Redacted backups will exclude passwords and tokens from user records.
* Restore operations skip existing resources unless `--force` is used.
* Resource creation order is dependency-aware (e.g., tenants → projects → users).

== License ==
MIT or internal use.

== Maintainer ==
Daniel Roessner

SpectroCloud

2025-04-15T13:06:44Z

Ders:

[[SpectroCloud/VertexInstall | Vertex Installation Instructions]] 
[[SpectroCloud/VertexISOInstall | Vertex ISO Installation Instructions]] 
[[SpectroCloud/VertexHelmInstall | Vertex Helm Installation Instructions]] 
[[SpectroCloud/VertexUpgrade | Vertex Upgrade Instructions]] 
[[SpectroCloud/VertexLabConfig | Vertex Lab Configuration]] 
[[SpectroCloud/MAAS | MAAS Information]] 
[[SpectroCloud/RaspberryPiEdgePrep | RaspberryPi Edge Prep]] 
[[SpectroCloud/RaspberryPiEdge | RaspberryPi Edge]] 
[[SpectroCloud/Packs | Packs]] 
[[SpectroCloud/AirGapEdgeISO | Air-Gapped Edge ISO]] 

[[SpectroCloud/PaletteBackup | Palette Backup Script]]

SpectroCloud/RaspberryPiEdge

2025-04-11T16:38:45Z

Ders: /* Troubleshooting */

=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":"{{highlight|<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 -

SpectroCloud/RaspberryPiEdge

2025-04-11T16:37:56Z

Ders: /* Troubleshooting */

=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 -

SpectroCloud/RaspberryPiEdge

2025-04-11T16:31:33Z

Ders: /* Appendix */

SpectroCloud/RaspberryPiEdge

2025-04-11T16:03:24Z

Ders: /* Install Palette Agent */

SpectroCloud/RaspberryPiEdge

2025-04-11T16:03:04Z

Ders: /* Prepare Environment */

=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 ==
#################
# 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 AGENT_VERSION="v4.6.12"

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

##############################################################
# 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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T16:01:42Z

Ders: /* Raspberry Pi Edge Install */

=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 ==
#################
# 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 AGENT_VERSION="v4.6.12"

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

##############################################################
# 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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:59:23Z

Ders: /* Install Palette Agent */

=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"

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

snap install docker
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 ==
#################
# 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 AGENT_VERSION="v4.6.12"

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

##############################################################
# 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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:58:25Z

Ders: /* Install Palette Agent */

=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"

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

snap install docker
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 ==
#################
# SET VARIABLES #
#################
export AGENT_VERSION='4.6.12'

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

##############################################################
# 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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:56:34Z

Ders: /* Install Palette Agent */

=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"

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

snap install docker
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 ==
#################
# SET VARIABLES #
#################
export AGENT_VERSION='4.6.12'

#############################
# Install Required Software #
#############################
#sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

##############################################################
# 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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:52:24Z

Ders: /* Install Palette Agent */

=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"

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

snap install docker
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 ==
#################
# SET VARIABLES #
#################
export EDGE_API_VERSION='4.6.12'

#############################
# Install Required Software #
#############################
#sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

##############################################################
# 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$EDGE_API_VERSION
docker save us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:v$EDGE_API_VERSION > arm-agent-$EDGE_API_VERSION.tar

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v$EDGE_API_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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:48:49Z

Ders: /* Install Palette Agent */

=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"

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

snap install docker
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 ==
#################
# SET VARIABLES #
#################
export EDGE_API_VERSION='v4.6.12'

#############################
# Install Required Software #
#############################
#sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

##############################################################
# 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:$EDGE_API_VERSION
docker save us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:$EDGE_API_VERSION > arm-agent-$EDGE_API_VERSION.tar

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v$EDGE_API_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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:48:18Z

Ders: /* Raspberry Pi Edge Install */

=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"

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

snap install docker
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 ==
#################
# SET VARIABLES #
#################
export EDGE_API_VERSION='v4.6.12'

#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

##############################################################
# 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:$EDGE_API_VERSION
docker save us-docker.pkg.dev/palette-images/edge/stylus-agent-mode-linux-arm64:$EDGE_API_VERSION > arm-agent-$EDGE_API_VERSION.tar

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v$EDGE_API_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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:46:42Z

Ders: /* Install Palette Agent */

=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"

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

snap install docker
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 ==

#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:44:54Z

Ders: /* Install Palette Agent */

=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"

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

snap install docker
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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:42:48Z

Ders: /* Prepare Environment */

=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"

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

snap install docker
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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:42:21Z

Ders: /* Prepare Environment */

=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"

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

snap install docker
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 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 $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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:41:04Z

Ders: /* Prepare Environment */

=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"

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

snap install docker
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://ders-vertex.dersllc.com/system
# Administration -> Pack Registries -> DERS-Harbor -> sync

################################################
# Pull the arm64 agent and push to Airgap Repo #
################################################
docker pull 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 $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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:24:24Z

Ders: /* Prepare Environment */

=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"

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

snap install docker
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
bash /nfs/Download/airgap-vertex-pack-edge-native-byoi-2.1.0.bin

###########################
# Sync the Repo in Vertex #
###########################
# Navigate to: https://ders-vertex.dersllc.com/system
# Administration -> Pack Registries -> DERS-Harbor -> sync

################################################
# Pull the arm64 agent and push to Airgap Repo #
################################################
docker pull 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 $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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:22:47Z

Ders: /* Prepare Environment */

=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 -> Palette Release -> Vertex Info -> Airgap Binaries -> edge-native-byoi

#############################
## 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"

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

snap install docker
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
bash /nfs/Download/airgap-vertex-pack-edge-native-byoi-2.1.0.bin

###########################
# Sync the Repo in Vertex #
###########################
# Navigate to: https://ders-vertex.dersllc.com/system
# Administration -> Pack Registries -> DERS-Harbor -> sync

################################################
# Pull the arm64 agent and push to Airgap Repo #
################################################
docker pull 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 $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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:19:36Z

Ders: /* Prepare Environment */

=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 -> Palette Release -> Vertex Info -> Airgap Binaries -> edge-native-byoi

#############################
## 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.3"

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

snap install docker
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
bash /nfs/Download/airgap-vertex-pack-edge-native-byoi-2.1.0.bin

###########################
# Sync the Repo in Vertex #
###########################
# Navigate to: https://ders-vertex.dersllc.com/system
# Administration -> Pack Registries -> DERS-Harbor -> sync

################################################
# Pull the arm64 agent and push to Airgap Repo #
################################################
docker pull 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 $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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T15:18:50Z

Ders: /* Prepare Environment */

=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 -> Palette Release -> Vertex Info -> Airgap Binaries -> edge-native-byoi

#############################
## 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 AGENT_VERSION="v4.6.3"

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

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

bash /nfs/Download/airgap-pack-edge-k3s-1.32.1.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
bash /nfs/Download/airgap-vertex-pack-edge-native-byoi-2.1.0.bin
bash /nfs/Download/airgap-vertex-pack-edge-rke2-1.31.4.bin

###########################
# Sync the Repo in Vertex #
###########################
# Navigate to: https://ders-vertex.dersllc.com/system
# Administration -> Pack Registries -> DERS-Harbor -> sync

################################################
# Pull the arm64 agent and push to Airgap Repo #
################################################
docker pull 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 $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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/RaspberryPiEdge

2025-04-11T14:53:33Z

Ders:

=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-rke2 -> <k8s_version>
# Location: RETOOL -> Palette Release -> Vertex Info -> Airgap Binaries -> edge-native-byoi

#############################
## 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=spectro-images
export OCI_PACK_REGISTRY=harbor.dersllc.com
export OCI_PACK_BASE=spectro-packs
export AGENT_VERSION="v4.6.3"

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

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

bash /nfs/Download/airgap-vertex-pack-edge-native-byoi-2.1.0.bin
bash /nfs/Download/airgap-vertex-pack-edge-rke2-1.31.4.bin

###########################
# Sync the Repo in Vertex #
###########################
# Navigate to: https://ders-vertex.dersllc.com/system
# Administration -> Pack Registries -> DERS-Harbor -> sync

################################################
# Pull the arm64 agent and push to Airgap Repo #
################################################
docker pull 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 $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 ==
#############################
# Install Required Software #
#############################
sudo snap install curl
sudo apt-get install jq zstd rsync conntrack -y

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

##################################
# Download the palette-agent CLI #
##################################
export URL=https://github.com/spectrocloud/agent-mode/releases/download/v4.6.3/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-$EDGE_API_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 ==

SpectroCloud/VertexInstall

2025-04-10T17:33:42Z

Ders: /* Vertex Install Steps */

=Vertex Installation Instructions=
==Vertex Installation==
===Pre Requisites===
====1. Needed Downloads====
* RETOOL Location: Palette-Release -> Vertex Info -> Binaries
Airgap Binaries: Release Binary
Command Line Tools: Palette CLI Linux
* RETOOL Location: Palette-Release -> Vertex Info -> Capi OS Images
Search: "<supported version #>"
Download: k8s_fips for vmware
NOTE: find supported versions via https://docs.spectrocloud.com/release-notes/
* RETOOL Location: Palette-Release -> Vertex Info -> Airgap Binaries
Search: "airgap-vertex-pack-kubernetes"
Download: kubernetes for <supported version>
NOTE: find supported versions via https://docs.spectrocloud.com/release-notes/


====2. vCenter Prep ====
* Tag the DataCenter with k8s-region
<center>[[File:TagDatacenter.png|options|Datacenter Tag]]</center>
* Tag the Cluster with k8s-zone
<center>[[File:TagCluster.png|options|Cluster Tag]]</center>
* Create a VM Folder called spectro-templates
* Create a VM Folder called spectro-vms
<center> [[File:VmFolders.png|options|Create Folders]]</center>
* Import the k8s_fips OVA (ex. u-2004-0-k-1305-fips.ova)
** Rename Image to "r_u-2004-0-k-<version>-fips" (ex. r_u-2004-0-k-1305-fips)
** Convert VM to Template.

====3. Jumpbox Setup====

#############################
# Install Required Software #
#############################
apt update
apt upgrade -y
apt-get -y install snapd unzip nfs-common ca-certificates zip
snap install oras --classic

##################################################
# Log-in via Docker and ORAS and upload the SCAR #
##################################################
docker login harbor.dersllc.com -u admin -p '<Password>'

oras login harbor.dersllc.com --username 'admin' --password '<Password>'


#####################################################
# Setup NFS Mount (NOT REQUIRED, DERS LAB SPECIFIC) #
#####################################################
mkdir -p /opt/spectro/ssl/
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key


echo "172.16.85.15:/Download /nfs/Download nfs vers=4.0 0 0" >> /etc/fstab
mkdir -p /nfs/Download
mount -a

######################################################
# Trust DERS Certs (NOT REQUIRED, DERS LAB SPECIFIC) #
######################################################
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



====4. Harbor Prep====
* Create a new Public Project (spectro-images)
* Create a new Public Project (spectro-packs)

===Vertex Install Steps===
#################
# 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 SC_VERSION='4.6.18'

#################################
# Import Containers into Harbor #
#################################
chmod +x /nfs/Download/airgap-vertex-*
/nfs/Download/airgap-vertex-v$SC_VERSION.bin --nodiskspace --target /nfs/Download/airgap-vertex-v$SC_VERSION/

#######################
# Install Palette CLI #
#######################

mv /nfs/Download/palette /usr/local/bin/palette
chmod +x /usr/local/bin/palette

# Encryption
export PALETTE_ENCRYPTION_PASSWORD='VERTEX1234!vertex1234!'

# SSH to sc-deploy and run:
palette version
#Note: make sure it is at least 4.5.7

palette ec install

# No palette CLI config file detected. One will be created.
# Management Plane Type:
 Palette VerteX 
# Operating System:
 ubuntu 
# Enable Ubuntu Pro (required for production)? [y/N]: Yes 
# Ubuntu Pro token: C12HPMun5ibCKAqtW%cqBpaL66RNjd 
# enabling experimental podman provider
# No kind clusters found.
# Cloud Type:
 VMware vSphere 

###################################
# Enter Environment Configuration #
###################################
# HTTPS Proxy (optional, hit enter to skip):
# HTTP Proxy (optional, hit enter to skip):
# Pod CIDR: 192.168.0.0/16
# Service IP Range: 10.96.0.0/12
#############################################
# Enter Pack & Image Registry Configuration #
#############################################
# Registry Type:
 OCI 
# Registry Name:
 DERS-Harbor 
# Registry Endpoint:
https://harbor.dersllc.com 
# Registry Base Content Path (optional, hit enter to skip):
airgap-spectro-images
# Registry CA certificate Filepath (optional, hit enter to skip):
/usr/local/share/ca-certificates/ders-star-ca.crt
# Registry Username (optional, hit enter to skip):
admin
# Registry Password (optional, hit enter to skip):
*********
# Enter 'Y' to pull images from public registries or 'N' to specify an OCI image registry
# Pull images from public registries? [Y/n]:
No
# Use the same OCI Registry for packs & images? [Y/n]:
Yes
# Registry Base Content Path (optional, hit enter to skip):
airgap-spectro-packs
#######################
# Collecting Metadata #
#######################
# Kind Cluster Name:
 spectro-mgmt-cluster 
#####################################
# Enter vSphere Account Information #
#####################################
# vSphere Endpoint:
vcenter.dersllc.com
# vSphere Username (with domain):
administrator@ders.lab
# vSphere Password:
*********
# Allow Insecure Connection (Bypass x509 Verification)? [Y/n]:
Yes
##################################################
# Enter vSphere Enterprise Cluster configuration #
##################################################
# Datacenter:
DERSLLC
# VM Folder:
spectro-vms
# Image Template Folder:
spectro-templates
# Cluster for Fault Domain:
Lab
# Network:
DERS-87
# Resource Pool:
Default (root resource pool for cluster: Lab)
# Select specific Datastore or use a VM Storage Policy:
Datastore
# Datastore:
DERS-HDD
# Unable to add another Fault Domain as no Clusters remain in Datacenter DERSLLC
# NTP servers (comma-separated domain names or IP addresses, optional) (optional, hit enter to skip):
172.16.84.21
# Configure SSH public key(s)
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDngCrc1Na1xES5nnSBHxw1MMcwEwFL4TpwbSTq4BlcKb4WUGE4AOXr4W4RenB6OTyLkHOeLNc2ptILF3PZQG44SZ+uZMBLhx82DYbMq75F6WDSd7wnHA0cL90ncXGoLnwk+UnNEg59zmhYbrMEVM5OS3k0Ll/EXUb9PUsE+SdEoKDG+84OiwCQnQ+DWr9R79NHwLKflOvIMtoZuFwjObQ7xbsTO27FhL8wbcUDqygVqq+6r6adyZ1yEuqhXRkzUgQWv/rIzATaLTZp5r3kCGRe+EkB6AlapwE1O139ZGuY4m/FlIeXO1Ty0mmF88dI0CsbFUJcKKnO07nzSBhQevRr
# Specify a static IP range for assigning static IPs to cluster node(s).
# The IP range must contain at least 5 IPs.
# Start IP:
172.16.85.200
# End IP:
172.16.85.220
# Network Prefix:
22
# Gateway IP Address:
172.16.84.1
# Name servers (comma-separated IP addresses):
172.16.84.10
# Name server search suffixes (Optional) (optional, hit enter to skip):
dersllc.com
###################################################################
# Enter vSphere Machine configuration for the Enterprise Cluster #
###################################################################
# Select combination:
S: 16 CPU, 32 GB memory, 60 GB storage, 20 GB database with 4 CPU limit and 8 GB memory limit
# Node Affinity: Enter 'y' to schedule all Palette pods on control plane nodes? [y/N]:
No

===Possible Install Help===
# add-on deployment not finishing
Restart the cluster-management-agent
===Vertex UI===
https://ders-vertex.dersllc.com/system

==Troubleshooting==
===spectro mgmt self link creation is still pending===
Error:
spectro mgmt self link creation is still pending
Fix:
Restart the spectrocluster Deployment
===Failed to apply cert renewal plan for first time push of certs===
Error:
Failed to apply cert renewal plan for first time push of certs
Fix:
Restart the Palette-Controller-Manager Deployment
===No Helm Charts Showing up in Profile creation===
Error:
Helm results empty
Fix:
Navigate to "Tenant Settings" -> Platform -> Platform Settings
Enable "Allow non-FIPS packs"
Enable "Allow non-FIPS features"
=== ORAS Pull and Push ===
oras login harbor.dersllc.com --username 'admin' --password '<password>'
oras pull harbor.dersllc.com/vertex-fips/rc-fips/4.5/spectro-packs/archive/ubuntu-maas:20.04
oras push harbor.dersllc.com/spectro-packs/spectro-packs/archive/ubuntu-maas:20.04 ubuntu-maas-20.04.tar.gz --insecure --annotation org.opencontainers.image.created="2023-07-24T11:57:56Z"

* ??Download Certs
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key

SpectroCloud/VertexInstall

2025-04-10T17:10:56Z

Ders: /* Vertex Install Steps */

=Vertex Installation Instructions=
==Vertex Installation==
===Pre Requisites===
====1. Needed Downloads====
* RETOOL Location: Palette-Release -> Vertex Info -> Binaries
Airgap Binaries: Release Binary
Command Line Tools: Palette CLI Linux
* RETOOL Location: Palette-Release -> Vertex Info -> Capi OS Images
Search: "<supported version #>"
Download: k8s_fips for vmware
NOTE: find supported versions via https://docs.spectrocloud.com/release-notes/
* RETOOL Location: Palette-Release -> Vertex Info -> Airgap Binaries
Search: "airgap-vertex-pack-kubernetes"
Download: kubernetes for <supported version>
NOTE: find supported versions via https://docs.spectrocloud.com/release-notes/


====2. vCenter Prep ====
* Tag the DataCenter with k8s-region
<center>[[File:TagDatacenter.png|options|Datacenter Tag]]</center>
* Tag the Cluster with k8s-zone
<center>[[File:TagCluster.png|options|Cluster Tag]]</center>
* Create a VM Folder called spectro-templates
* Create a VM Folder called spectro-vms
<center> [[File:VmFolders.png|options|Create Folders]]</center>
* Import the k8s_fips OVA (ex. u-2004-0-k-1305-fips.ova)
** Rename Image to "r_u-2004-0-k-<version>-fips" (ex. r_u-2004-0-k-1305-fips)
** Convert VM to Template.

====3. Jumpbox Setup====

#############################
# Install Required Software #
#############################
apt update
apt upgrade -y
apt-get -y install snapd unzip nfs-common ca-certificates zip
snap install oras --classic

##################################################
# Log-in via Docker and ORAS and upload the SCAR #
##################################################
docker login harbor.dersllc.com -u admin -p '<Password>'

oras login harbor.dersllc.com --username 'admin' --password '<Password>'


#####################################################
# Setup NFS Mount (NOT REQUIRED, DERS LAB SPECIFIC) #
#####################################################
mkdir -p /opt/spectro/ssl/
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key


echo "172.16.85.15:/Download /nfs/Download nfs vers=4.0 0 0" >> /etc/fstab
mkdir -p /nfs/Download
mount -a

######################################################
# Trust DERS Certs (NOT REQUIRED, DERS LAB SPECIFIC) #
######################################################
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



====4. Harbor Prep====
* Create a new Public Project (spectro-images)
* Create a new Public Project (spectro-packs)

===Vertex Install Steps===
#################
# 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 SC_VERSION='4.6.18'

#################################
# Import Containers into Harbor #
#################################
chmod +x /nfs/Download/airgap-vertex-*
/nfs/Download/airgap-vertex-v$SC_VERSION.bin --nodiskspace --target /nfs/Download/airgap-vertex-v$SC_VERSION/

#######################
# Install Palette CLI #
#######################

mv /nfs/Download/palette /usr/local/bin/palette
chmod +x /usr/local/bin/palette

# Encryption
export PALETTE_ENCRYPTION_PASSWORD='VERTEX1234!vertex1234!'

# SSH to sc-deploy and run:
palette version
#Note: make sure it is at least 4.5.7

palette ec install

# No palette CLI config file detected. One will be created.
# Management Plane Type:
 Palette VerteX 
# Operating System:
 ubuntu 
# Enable Ubuntu Pro (required for production)? [y/N]: Yes 
# Ubuntu Pro token: C12HPMun5ibCKAqtW%cqBpaL66RNjd 
# enabling experimental podman provider
# No kind clusters found.
# Cloud Type:
 VMware vSphere 

###################################
# Enter Environment Configuration #
###################################
# HTTPS Proxy (optional, hit enter to skip):
# HTTP Proxy (optional, hit enter to skip):
# Pod CIDR: 192.168.0.0/16
# Service IP Range: 10.96.0.0/12
#############################################
# Enter Pack & Image Registry Configuration #
#############################################
# Registry Type:
 OCI 
# Registry Name:
 DERS-Harbor 
# Registry Endpoint:
https://harbor.dersllc.com 
# Registry Base Content Path (optional, hit enter to skip):
spectro-images
# Registry CA certificate Filepath (optional, hit enter to skip):
/usr/local/share/ca-certificates/ders-star-ca.crt
# Registry Username (optional, hit enter to skip):
admin
# Registry Password (optional, hit enter to skip):
*********
# Enter 'Y' to pull images from public registries or 'N' to specify an OCI image registry
# Pull images from public registries? [Y/n]:
No
# Use the same OCI Registry for packs & images? [Y/n]:
Yes
# Registry Base Content Path (optional, hit enter to skip):
spectro-packs
#######################
# Collecting Metadata #
#######################
# Kind Cluster Name:
 spectro-mgmt-cluster 
#####################################
# Enter vSphere Account Information #
#####################################
# vSphere Endpoint:
vcenter.dersllc.com
# vSphere Username (with domain):
administrator@ders.lab
# vSphere Password:
*********
# Allow Insecure Connection (Bypass x509 Verification)? [Y/n]:
Yes
##################################################
# Enter vSphere Enterprise Cluster configuration #
##################################################
# Datacenter:
DERSLLC
# VM Folder:
spectro-vms
# Image Template Folder:
spectro-templates
# Cluster for Fault Domain:
Lab
# Network:
DERS-87
# Resource Pool:
Default (root resource pool for cluster: Lab)
# Select specific Datastore or use a VM Storage Policy:
Datastore
# Datastore:
DERS-HDD
# Unable to add another Fault Domain as no Clusters remain in Datacenter DERSLLC
# NTP servers (comma-separated domain names or IP addresses, optional) (optional, hit enter to skip):
172.16.84.21
# Configure SSH public key(s)
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDngCrc1Na1xES5nnSBHxw1MMcwEwFL4TpwbSTq4BlcKb4WUGE4AOXr4W4RenB6OTyLkHOeLNc2ptILF3PZQG44SZ+uZMBLhx82DYbMq75F6WDSd7wnHA0cL90ncXGoLnwk+UnNEg59zmhYbrMEVM5OS3k0Ll/EXUb9PUsE+SdEoKDG+84OiwCQnQ+DWr9R79NHwLKflOvIMtoZuFwjObQ7xbsTO27FhL8wbcUDqygVqq+6r6adyZ1yEuqhXRkzUgQWv/rIzATaLTZp5r3kCGRe+EkB6AlapwE1O139ZGuY4m/FlIeXO1Ty0mmF88dI0CsbFUJcKKnO07nzSBhQevRr
# Specify a static IP range for assigning static IPs to cluster node(s).
# The IP range must contain at least 5 IPs.
# Start IP:
172.16.85.200
# End IP:
172.16.85.220
# Network Prefix:
22
# Gateway IP Address:
172.16.84.1
# Name servers (comma-separated IP addresses):
172.16.84.10
# Name server search suffixes (Optional) (optional, hit enter to skip):
dersllc.com
###################################################################
# Enter vSphere Machine configuration for the Enterprise Cluster #
###################################################################
# Select combination:
S: 16 CPU, 32 GB memory, 60 GB storage, 20 GB database with 4 CPU limit and 8 GB memory limit
# Node Affinity: Enter 'y' to schedule all Palette pods on control plane nodes? [y/N]:
No

===Possible Install Help===
# add-on deployment not finishing
Restart the cluster-management-agent
===Vertex UI===
https://ders-vertex.dersllc.com/system

==Troubleshooting==
===spectro mgmt self link creation is still pending===
Error:
spectro mgmt self link creation is still pending
Fix:
Restart the spectrocluster Deployment
===Failed to apply cert renewal plan for first time push of certs===
Error:
Failed to apply cert renewal plan for first time push of certs
Fix:
Restart the Palette-Controller-Manager Deployment
===No Helm Charts Showing up in Profile creation===
Error:
Helm results empty
Fix:
Navigate to "Tenant Settings" -> Platform -> Platform Settings
Enable "Allow non-FIPS packs"
Enable "Allow non-FIPS features"
=== ORAS Pull and Push ===
oras login harbor.dersllc.com --username 'admin' --password '<password>'
oras pull harbor.dersllc.com/vertex-fips/rc-fips/4.5/spectro-packs/archive/ubuntu-maas:20.04
oras push harbor.dersllc.com/spectro-packs/spectro-packs/archive/ubuntu-maas:20.04 ubuntu-maas-20.04.tar.gz --insecure --annotation org.opencontainers.image.created="2023-07-24T11:57:56Z"

* ??Download Certs
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key

SpectroCloud/MAAS

2025-04-10T14:42:45Z

Ders: /* Upload Spectro Images to MAAS */

=MAAS Information=
==MAAS Install==
vi /etc/netplan/50-cloud-init.yaml
netplan apply
hostnamectl set-hostname MAAS
apt update -y
apt install nfs-common net-tools -y
snap install oras --classic
snap install docker
snap install k9s
echo "172.16.85.15:/Download /nfs/Download nfs vers=4.0 0 0" >> /etc/fstab
systemctl daemon-reload
mkdir -p /nfs/Download
mount -a
snap install maas
maas init region+rack --database-uri 'postgres://maas:DERS4me!@psql.dersllc.com/maas-new'
maas createadmin --username=admin --email=daniel.roessner@dersllc.com

==Upload Spectro Images to MAAS==
# SCP Files to MAAS Server
scp $IMAGE_NAME.tar.gz ders@172.16.84.39:/home/ders/

#Login to MAAS Server
ssh ders@172.16.84.39

export IMAGE_NAME='u-2204-0-k-1315-0'
export MAAS_IP='172.16.84.39'
### API Key is found @ http://172.16.84.39:5240/MAAS/r/account/prefs/api-keys
export MAAS_API_KEY='ZmT5y4KK5wBESpNvZs:FS6aHBn34Taz4QVm6B:n9thshcRPTjcPNx82wQUgwbwnfJFhjK6'

maas login maas http://$MAAS_IP:5240/MAAS/api/2.0 $MAAS_API_KEY

maas maas boot-resources create name=custom/$IMAGE_NAME architecture=amd64/generic content@=/home/ders/$IMAGE_NAME.tar.gz title=$IMAGE_NAME

== Deploy MAAS PCG ==
#Create VM with 4CPU and 8G of Memory and 50G Disk and Networking to VLAN-2
#PXE Boot the VM. This should register it with MAAS.
#In MAAS Commission the VM and add the Power Configuration.

#On a separate vm (TEMP-VM) Download the Palette-CLI.
wget --no-check-certificate https://software.spectrocloud.com/palette-cli/v4.5.4/linux/cli/palette -O /usr/bin/palette
chmod +x /usr/bin/palette

wget --no-check-certificate https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/maas-pcg/palette-cli-config.yaml -O palette-cli-config.yaml
palette login -c palette-cli-config.yaml --api-key 'NmZlMzFjMTljYmZlZTY2YzMyMjBmY2MzMmU5ZDAzZDc=' --org ders-lab --console-url https://vertex.dersllc.com

wget --no-check-certificate https://ders-gitlab.dersllc.com/ders/spectro-sa/-/raw/main/maas-pcg/pcg.yaml -O pcg.yaml
palette pcg install -f pcg.yaml

#Once complete this VM can be deleted.

== Other ==
us-docker.pkg.dev::harbor.dersllc.com/spectro-images
docker.io::harbor.dersllc.com/spectro-images/docker.io
gcr.io::harbor.dersllc.com/spectro-images/gcr.io
ghcr.io::harbor.dersllc.com/spectro-images/ghcr.io
k8s.gcr.io::harbor.dersllc.com/spectro-images/k8s.gcr.io
registry.k8s.io::harbor.dersllc.com/spectro-images/registry.k8s.io
quay.io::harbor.dersllc.com/spectro-images/quay.io
*::harbor.dersllc.com/spectro-images/*

SpectroCloud/VertexInstall

2025-04-08T13:11:38Z

Ders: /* Vertex Install Steps */

=Vertex Installation Instructions=
==Vertex Installation==
===Pre Requisites===
====1. Needed Downloads====
* RETOOL Location: Palette-Release -> Vertex Info -> Binaries
Airgap Binaries: Release Binary
Command Line Tools: Palette CLI Linux
* RETOOL Location: Palette-Release -> Vertex Info -> Capi OS Images
Search: "<supported version #>"
Download: k8s_fips for vmware
NOTE: find supported versions via https://docs.spectrocloud.com/release-notes/
* RETOOL Location: Palette-Release -> Vertex Info -> Airgap Binaries
Search: "airgap-vertex-pack-kubernetes"
Download: kubernetes for <supported version>
NOTE: find supported versions via https://docs.spectrocloud.com/release-notes/


====2. vCenter Prep ====
* Tag the DataCenter with k8s-region
<center>[[File:TagDatacenter.png|options|Datacenter Tag]]</center>
* Tag the Cluster with k8s-zone
<center>[[File:TagCluster.png|options|Cluster Tag]]</center>
* Create a VM Folder called spectro-templates
* Create a VM Folder called spectro-vms
<center> [[File:VmFolders.png|options|Create Folders]]</center>
* Import the k8s_fips OVA (ex. u-2004-0-k-1305-fips.ova)
** Rename Image to "r_u-2004-0-k-<version>-fips" (ex. r_u-2004-0-k-1305-fips)
** Convert VM to Template.

====3. Jumpbox Setup====

#############################
# Install Required Software #
#############################
apt update
apt upgrade -y
apt-get -y install snapd unzip nfs-common ca-certificates zip
snap install oras --classic

##################################################
# Log-in via Docker and ORAS and upload the SCAR #
##################################################
docker login harbor.dersllc.com -u admin -p '<Password>'

oras login harbor.dersllc.com --username 'admin' --password '<Password>'


#####################################################
# Setup NFS Mount (NOT REQUIRED, DERS LAB SPECIFIC) #
#####################################################
mkdir -p /opt/spectro/ssl/
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key


echo "172.16.85.15:/Download /nfs/Download nfs vers=4.0 0 0" >> /etc/fstab
mkdir -p /nfs/Download
mount -a

######################################################
# Trust DERS Certs (NOT REQUIRED, DERS LAB SPECIFIC) #
######################################################
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



====4. Harbor Prep====
* Create a new Public Project (spectro-images)
* Create a new Public Project (spectro-packs)

===Vertex Install Steps===
#################
# SET VARIABLES #
#################
export OCI_IMAGE_REGISTRY=harbor.dersllc.com
export OCI_IMAGE_BASE=spectro-images
export OCI_PACK_REGISTRY=harbor.dersllc.com
export OCI_PACK_BASE=spectro-packs
export SC_VERSION='4.6.18'

#################################
# Import Containers into Harbor #
#################################
chmod +x /nfs/Download/airgap-vertex-*
/nfs/Download/airgap-vertex-v$SC_VERSION.bin --nodiskspace --target /nfs/Download/airgap-vertex-v$SC_VERSION/

#######################
# Install Palette CLI #
#######################

mv /nfs/Download/palette /usr/local/bin/palette
chmod +x /usr/local/bin/palette

# Encryption
export PALETTE_ENCRYPTION_PASSWORD='VERTEX1234!vertex1234!'

# SSH to sc-deploy and run:
palette version
#Note: make sure it is at least 4.5.7

palette ec install

# No palette CLI config file detected. One will be created.
# Management Plane Type:
 Palette VerteX 
# Operating System:
 ubuntu 
# Enable Ubuntu Pro (required for production)? [y/N]: Yes 
# Ubuntu Pro token: C12HPMun5ibCKAqtW%cqBpaL66RNjd 
# enabling experimental podman provider
# No kind clusters found.
# Cloud Type:
 VMware vSphere 

###################################
# Enter Environment Configuration #
###################################
# HTTPS Proxy (optional, hit enter to skip):
# HTTP Proxy (optional, hit enter to skip):
# Pod CIDR: 192.168.0.0/16
# Service IP Range: 10.96.0.0/12
#############################################
# Enter Pack & Image Registry Configuration #
#############################################
# Registry Type:
 OCI 
# Registry Name:
 DERS-Harbor 
# Registry Endpoint:
https://harbor.dersllc.com 
# Registry Base Content Path (optional, hit enter to skip):
spectro-images
# Registry CA certificate Filepath (optional, hit enter to skip):
/usr/local/share/ca-certificates/ders-star-ca.crt
# Registry Username (optional, hit enter to skip):
admin
# Registry Password (optional, hit enter to skip):
*********
# Enter 'Y' to pull images from public registries or 'N' to specify an OCI image registry
# Pull images from public registries? [Y/n]:
No
# Use the same OCI Registry for packs & images? [Y/n]:
Yes
# Registry Base Content Path (optional, hit enter to skip):
spectro-packs
#######################
# Collecting Metadata #
#######################
# Kind Cluster Name:
 spectro-mgmt-cluster 
#####################################
# Enter vSphere Account Information #
#####################################
# vSphere Endpoint:
vcenter.dersllc.com
# vSphere Username (with domain):
administrator@ders.lab
# vSphere Password:
*********
# Allow Insecure Connection (Bypass x509 Verification)? [Y/n]:
Yes
##################################################
# Enter vSphere Enterprise Cluster configuration #
##################################################
# Datacenter:
DERSLLC
# VM Folder:
spectro-vms
# Image Template Folder:
spectro-templates
# Cluster for Fault Domain:
Lab
# Network:
DERS-87
# Resource Pool:
Default (root resource pool for cluster: Lab)
# Select specific Datastore or use a VM Storage Policy:
Datastore
# Datastore:
DERS-HDD
# Unable to add another Fault Domain as no Clusters remain in Datacenter DERSLLC
# NTP servers (comma-separated domain names or IP addresses, optional) (optional, hit enter to skip):
172.16.84.21
# Configure SSH public key(s)
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDngCrc1Na1xES5nnSBHxw1MMcwEwFL4TpwbSTq4BlcKb4WUGE4AOXr4W4RenB6OTyLkHOeLNc2ptILF3PZQG44SZ+uZMBLhx82DYbMq75F6WDSd7wnHA0cL90ncXGoLnwk+UnNEg59zmhYbrMEVM5OS3k0Ll/EXUb9PUsE+SdEoKDG+84OiwCQnQ+DWr9R79NHwLKflOvIMtoZuFwjObQ7xbsTO27FhL8wbcUDqygVqq+6r6adyZ1yEuqhXRkzUgQWv/rIzATaLTZp5r3kCGRe+EkB6AlapwE1O139ZGuY4m/FlIeXO1Ty0mmF88dI0CsbFUJcKKnO07nzSBhQevRr
# Specify a static IP range for assigning static IPs to cluster node(s).
# The IP range must contain at least 5 IPs.
# Start IP:
172.16.85.200
# End IP:
172.16.85.220
# Network Prefix:
22
# Gateway IP Address:
172.16.84.1
# Name servers (comma-separated IP addresses):
172.16.84.10
# Name server search suffixes (Optional) (optional, hit enter to skip):
dersllc.com
###################################################################
# Enter vSphere Machine configuration for the Enterprise Cluster #
###################################################################
# Select combination:
S: 16 CPU, 32 GB memory, 60 GB storage, 20 GB database with 4 CPU limit and 8 GB memory limit
# Node Affinity: Enter 'y' to schedule all Palette pods on control plane nodes? [y/N]:
No

===Possible Install Help===
# add-on deployment not finishing
Restart the cluster-management-agent
===Vertex UI===
https://ders-vertex.dersllc.com/system

==Troubleshooting==
===spectro mgmt self link creation is still pending===
Error:
spectro mgmt self link creation is still pending
Fix:
Restart the spectrocluster Deployment
===Failed to apply cert renewal plan for first time push of certs===
Error:
Failed to apply cert renewal plan for first time push of certs
Fix:
Restart the Palette-Controller-Manager Deployment
===No Helm Charts Showing up in Profile creation===
Error:
Helm results empty
Fix:
Navigate to "Tenant Settings" -> Platform -> Platform Settings
Enable "Allow non-FIPS packs"
Enable "Allow non-FIPS features"
=== ORAS Pull and Push ===
oras login harbor.dersllc.com --username 'admin' --password '<password>'
oras pull harbor.dersllc.com/vertex-fips/rc-fips/4.5/spectro-packs/archive/ubuntu-maas:20.04
oras push harbor.dersllc.com/spectro-packs/spectro-packs/archive/ubuntu-maas:20.04 ubuntu-maas-20.04.tar.gz --insecure --annotation org.opencontainers.image.created="2023-07-24T11:57:56Z"

* ??Download Certs
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key

SpectroCloud/VertexInstall

2025-04-08T13:10:40Z

Ders: /* Vertex Install Steps */

=Vertex Installation Instructions=
==Vertex Installation==
===Pre Requisites===
====1. Needed Downloads====
* RETOOL Location: Palette-Release -> Vertex Info -> Binaries
Airgap Binaries: Release Binary
Command Line Tools: Palette CLI Linux
* RETOOL Location: Palette-Release -> Vertex Info -> Capi OS Images
Search: "<supported version #>"
Download: k8s_fips for vmware
NOTE: find supported versions via https://docs.spectrocloud.com/release-notes/
* RETOOL Location: Palette-Release -> Vertex Info -> Airgap Binaries
Search: "airgap-vertex-pack-kubernetes"
Download: kubernetes for <supported version>
NOTE: find supported versions via https://docs.spectrocloud.com/release-notes/


====2. vCenter Prep ====
* Tag the DataCenter with k8s-region
<center>[[File:TagDatacenter.png|options|Datacenter Tag]]</center>
* Tag the Cluster with k8s-zone
<center>[[File:TagCluster.png|options|Cluster Tag]]</center>
* Create a VM Folder called spectro-templates
* Create a VM Folder called spectro-vms
<center> [[File:VmFolders.png|options|Create Folders]]</center>
* Import the k8s_fips OVA (ex. u-2004-0-k-1305-fips.ova)
** Rename Image to "r_u-2004-0-k-<version>-fips" (ex. r_u-2004-0-k-1305-fips)
** Convert VM to Template.

====3. Jumpbox Setup====

#############################
# Install Required Software #
#############################
apt update
apt upgrade -y
apt-get -y install snapd unzip nfs-common ca-certificates zip
snap install oras --classic

##################################################
# Log-in via Docker and ORAS and upload the SCAR #
##################################################
docker login harbor.dersllc.com -u admin -p '<Password>'

oras login harbor.dersllc.com --username 'admin' --password '<Password>'


#####################################################
# Setup NFS Mount (NOT REQUIRED, DERS LAB SPECIFIC) #
#####################################################
mkdir -p /opt/spectro/ssl/
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key


echo "172.16.85.15:/Download /nfs/Download nfs vers=4.0 0 0" >> /etc/fstab
mkdir -p /nfs/Download
mount -a

######################################################
# Trust DERS Certs (NOT REQUIRED, DERS LAB SPECIFIC) #
######################################################
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



====4. Harbor Prep====
* Create a new Public Project (spectro-images)
* Create a new Public Project (spectro-packs)

===Vertex Install Steps===
#################
# SET VARIABLES #
#################
export OCI_IMAGE_REGISTRY=harbor.dersllc.com
export OCI_IMAGE_BASE=spectro-images
export OCI_PACK_REGISTRY=harbor.dersllc.com
export OCI_PACK_BASE=spectro-packs
export SC_VERSION='4.6.18'

#################################
# Import Containers into Harbor #
#################################
chmod +x /nfs/Download/airgap-vertex-*
/nfs/Download/airgap-vertex-v$SC_VERSION.bin --nodiskspace --target /nfs/Download/airgap-vertex-v$SC_VERSION/

#######################
# Install Palette CLI #
#######################
source /nfs/Download/airgap-vertex-v$SC_VERSION/bin/functions.sh; cli_copy
mv /nfs/Download/palette /usr/local/bin/palette
chmod +x /usr/local/bin/palette

# Encryption
export PALETTE_ENCRYPTION_PASSWORD='VERTEX1234!vertex1234!'

# SSH to sc-deploy and run:
palette version
#Note: make sure it is at least 4.5.7

palette ec install

# No palette CLI config file detected. One will be created.
# Management Plane Type:
 Palette VerteX 
# Operating System:
 ubuntu 
# Enable Ubuntu Pro (required for production)? [y/N]: Yes 
# Ubuntu Pro token: C12HPMun5ibCKAqtW%cqBpaL66RNjd 
# enabling experimental podman provider
# No kind clusters found.
# Cloud Type:
 VMware vSphere 

###################################
# Enter Environment Configuration #
###################################
# HTTPS Proxy (optional, hit enter to skip):
# HTTP Proxy (optional, hit enter to skip):
# Pod CIDR: 192.168.0.0/16
# Service IP Range: 10.96.0.0/12
#############################################
# Enter Pack & Image Registry Configuration #
#############################################
# Registry Type:
 OCI 
# Registry Name:
 DERS-Harbor 
# Registry Endpoint:
https://harbor.dersllc.com 
# Registry Base Content Path (optional, hit enter to skip):
spectro-images
# Registry CA certificate Filepath (optional, hit enter to skip):
/usr/local/share/ca-certificates/ders-star-ca.crt
# Registry Username (optional, hit enter to skip):
admin
# Registry Password (optional, hit enter to skip):
*********
# Enter 'Y' to pull images from public registries or 'N' to specify an OCI image registry
# Pull images from public registries? [Y/n]:
No
# Use the same OCI Registry for packs & images? [Y/n]:
Yes
# Registry Base Content Path (optional, hit enter to skip):
spectro-packs
#######################
# Collecting Metadata #
#######################
# Kind Cluster Name:
 spectro-mgmt-cluster 
#####################################
# Enter vSphere Account Information #
#####################################
# vSphere Endpoint:
vcenter.dersllc.com
# vSphere Username (with domain):
administrator@ders.lab
# vSphere Password:
*********
# Allow Insecure Connection (Bypass x509 Verification)? [Y/n]:
Yes
##################################################
# Enter vSphere Enterprise Cluster configuration #
##################################################
# Datacenter:
DERSLLC
# VM Folder:
spectro-vms
# Image Template Folder:
spectro-templates
# Cluster for Fault Domain:
Lab
# Network:
DERS-87
# Resource Pool:
Default (root resource pool for cluster: Lab)
# Select specific Datastore or use a VM Storage Policy:
Datastore
# Datastore:
DERS-HDD
# Unable to add another Fault Domain as no Clusters remain in Datacenter DERSLLC
# NTP servers (comma-separated domain names or IP addresses, optional) (optional, hit enter to skip):
172.16.84.21
# Configure SSH public key(s)
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDngCrc1Na1xES5nnSBHxw1MMcwEwFL4TpwbSTq4BlcKb4WUGE4AOXr4W4RenB6OTyLkHOeLNc2ptILF3PZQG44SZ+uZMBLhx82DYbMq75F6WDSd7wnHA0cL90ncXGoLnwk+UnNEg59zmhYbrMEVM5OS3k0Ll/EXUb9PUsE+SdEoKDG+84OiwCQnQ+DWr9R79NHwLKflOvIMtoZuFwjObQ7xbsTO27FhL8wbcUDqygVqq+6r6adyZ1yEuqhXRkzUgQWv/rIzATaLTZp5r3kCGRe+EkB6AlapwE1O139ZGuY4m/FlIeXO1Ty0mmF88dI0CsbFUJcKKnO07nzSBhQevRr
# Specify a static IP range for assigning static IPs to cluster node(s).
# The IP range must contain at least 5 IPs.
# Start IP:
172.16.85.200
# End IP:
172.16.85.220
# Network Prefix:
22
# Gateway IP Address:
172.16.84.1
# Name servers (comma-separated IP addresses):
172.16.84.10
# Name server search suffixes (Optional) (optional, hit enter to skip):
dersllc.com
###################################################################
# Enter vSphere Machine configuration for the Enterprise Cluster #
###################################################################
# Select combination:
S: 16 CPU, 32 GB memory, 60 GB storage, 20 GB database with 4 CPU limit and 8 GB memory limit
# Node Affinity: Enter 'y' to schedule all Palette pods on control plane nodes? [y/N]:
No

===Possible Install Help===
# add-on deployment not finishing
Restart the cluster-management-agent
===Vertex UI===
https://ders-vertex.dersllc.com/system

==Troubleshooting==
===spectro mgmt self link creation is still pending===
Error:
spectro mgmt self link creation is still pending
Fix:
Restart the spectrocluster Deployment
===Failed to apply cert renewal plan for first time push of certs===
Error:
Failed to apply cert renewal plan for first time push of certs
Fix:
Restart the Palette-Controller-Manager Deployment
===No Helm Charts Showing up in Profile creation===
Error:
Helm results empty
Fix:
Navigate to "Tenant Settings" -> Platform -> Platform Settings
Enable "Allow non-FIPS packs"
Enable "Allow non-FIPS features"
=== ORAS Pull and Push ===
oras login harbor.dersllc.com --username 'admin' --password '<password>'
oras pull harbor.dersllc.com/vertex-fips/rc-fips/4.5/spectro-packs/archive/ubuntu-maas:20.04
oras push harbor.dersllc.com/spectro-packs/spectro-packs/archive/ubuntu-maas:20.04 ubuntu-maas-20.04.tar.gz --insecure --annotation org.opencontainers.image.created="2023-07-24T11:57:56Z"

* ??Download Certs
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key