Skip to content
34 changes: 34 additions & 0 deletions _partials/_canvos-edge-arg-file.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
partial_category: palette-edge-canvos-version
partial_name: canvos-edge-arg-file
---

Specify the system architecture, OS distribution, and version. These configurations apply to your Edge host's OS both before and after cluster formation.

<li>Specify the Kubernetes distribution and version. This is used with the OS distribution and version to create an immutable provider image with your specified OS and Kubernetes. </li>

:::info

To build multiple versions of a provider image with different Kubernetes versions, use the `k8s_version.json` file in the repository. You must leave the `K8S_VERSION` field in your `.arg` file empty to use the JSON file. This file is only used when `K8S_VERSION` is not detected as an argument.

:::

<li>Specify the image registry, image repository name, and custom tag for your provider images. The custom tag, together with the Palette agent version (the same number as the Git tag you are using), the version and distribution of Kubernetes, and the OS used by the image forms the tag of the image.</li>


For example, if your `.arg` file contains the following arguments, the full image reference would be
`ttl.sh/ubuntu:k3s-1.33.5-v4.7.2-demo`.

```text
IMAGE_REGISTRY=ttl.sh
IMAGE_REPO=ubuntu
CUSTOM_TAG=demo
K8S_DISTRIBUTION=k3s
K8S_VERSION=1.33.5
OS_DISTRIBUTION=ubuntu
OS_VERSION=22
```

The `.arg` file uses the default values for any remaining arguments. Refer to [Edge Artifact Build Configurations](/clusters/edge/edgeforge-workflow/palette-canvos/arg/) for all available `.arg` configuration parameters.

Using the arguments defined in the `.arg` file, the final provider images you generate will have the following naming convention, `[IMAGE_REGISTRY]/[IMAGE_REPO]:[CUSTOM_TAG]`. For example, one of the provider images might be `spectrocloud/ubuntu:k3s-1.33.5-v4.7.2-palette-learn`.
19 changes: 19 additions & 0 deletions _partials/_canvos-edge-user-data.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
partial_category: palette-edge-canvos-version
partial_name: canvos-edge-user-data
---

From the CanvOS directory, copy the **user-data.template** file and name the copy **user-data**. Edit the `user-data` file to include the following fields under `stylus.site`.
- `edgeHostToken`
- `paletteEndpoint`
- `projectName`

The `user-data` file uses the `cloud-init` `cloud-config` format. The first line of your file must be `#cloud-config` to ensure that `cloud-init` recognizes and applies the configuration correctly. Delete any unused arguments.

```shell
#cloud-config
stylus:
site:
...
```
Refer to [Prepare User Data and Argument Files](/clusters/edge/edgeforge-workflow/prepare-user-data/) for more information about configuring your `user-data` file and to review sample files for different use cases. Refer to [Cloud Init Stages](/clusters/edge/edge-configuration/cloud-init/), and the [Edge Installer Configuration Reference](/clusters/edge/edge-configuration/installer-reference/) for supported keys and stages.
Loading
Loading