Skip to main content

Install Configuration

The Edge Installer is responsible for preparing the Edge host to be ready for assignment to cluster workloads. The Edge Installer supports the ability to specify a configuration file named user-data. You can use this configuration file to customize the installation and ensure your Edge host has all the required dependencies and settings to work properly in your environment. For more information about all the available parameters in the installer configuration, refer to Installer Reference.

To better understand the Edge installation process, review the order of operations from installation to Edge host registration.

Order of Operations​

  1. Boot device with Edge Installer.

  2. Edge Installer installs Palette Edge onto the Edge host.

  3. Device powers off or reboots to registration mode based on the user data configuration.

  4. Upon boot up or reboot, cloud-init stages that are specified in the user data configuration file take effect.

  5. Edge Host Registers with Palette and is ready to be part of a cluster.

The boot order sequence, listing steps that flow in a sequential order.

Palette Edge allows you to use cloud-init stages to declaratively configure your Operating System (OS) of your Edge host both using installer configuration user-data and in the OS pack. For more information about cloud-init stages, refer to Cloud-init Stages.

Edge Installer Configuration​

The Edge installation process expects you to specify installation parameters. You can supply the install parameters in multiple stages. You can provide common installation configurations during EdgeForge for all your sites during the manufacturing or provide site-specific configuration during on-site deployment. For more information, refer to Prepare User Data and Apply Site User Data. The install configurations provided in various stages are merged to create the Edge host's final configuration.

Installer Example Configuration​

The following example shows how user data configuration is used to customize the Edge host installation process.

#cloud-config
stylus:
  site:
    paletteEndpoint: api.spectrocloud.com
    edgeHostToken: yourEdgeRegistrationTokenHere
    projectUid: 12345677788
    tags:
      env: east
      terraform_managed: true
      os: ubuntu
    name: edge-59d3f182-35fe-4e10-b0a0-d7f761f1a142

    network:
      httpProxy: http://proxy.example.com
      httpsProxy: https://proxy.example.com
      noProxy: 10.10.128.10,10.0.0.0/8
      nameserver: 1.1.1.1
      interfaces:
        enp0s3:
          type: static
          ipAddress: 10.0.10.25/24
          gateway: 10.0.10.1
          nameserver: 10.10.128.8
        enp0s4:
          type: dhcp
    caCerts:
      - |
        ------BEGIN CERTIFICATE------
        *****************************
        *****************************
        ------END CERTIFICATE------
      - |
        ------BEGIN CERTIFICATE------
        *****************************
        *****************************
        ------END CERTIFICATE------
info

Check out the Prepare User Data resource for more examples.

Additional Configurations​

The Edge Installer will honor other Kairos parameters, such as install, and options. To learn more about Kairos parameters, refer to the Kairos configuration page.

The following is an example Edge installer configuration that is using the install parameter block to power off the device upon completion of the installation process.

#cloud-config
stylus:
  site:
    paletteEndpoint: api.spectrocloud.com
    registrationURL: https://edge-registration.vercel.app
    projectUid: yourProjectIdHere
    edgeHostToken: yourEdgeRegistrationTokenHere
    tags:
      myTag: myValue
      myOtherTag: myOtherValue
    tagsFromScript:
      scriptName: /etc/palette/tags.sh
      timeout: 30
  reboot: false

stages:
  initramfs:
    - users:
        palette:
          groups:
            - sudo
          passwd: palette

install:
  poweroff: true

Resources​