You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
BYOOS enables you to use a custom OS for your Edge host. The custom OS must include all the Edge artifacts and provider
22
+
images required by the Edge Installer. Refer to the
23
+
[Build Edge Artifacts](../clusters/edge/edgeforge-workflow/palette-canvos/palette-canvos.md) guide for steps on how to
24
+
create a custom OS that includes all the required components for the Edge Installer.
25
+
26
+
Next, select the BYOOS pack and fill out the required parameters during the cluster profile creation process.
27
+
28
+
The `options.system.uri` parameter specifies the location of the BYOOS image. This parameter is required and included in your pack YAML file by default.
29
+
30
+
The following section provides the list of optional parameters you can customize in the pack YAML file.
31
+
32
+
### Customizable Optional Parameters
33
+
34
+
You can customize the following sections of the pack YAML file:
35
+
36
+
* The `drain` section is included by default and controls how nodes are drained during cluster upgrades. If you do not make any changes in this section, the default drain values are used.
37
+
38
+
* The `providerCredentials` section supplies the credentials for the registry that contains your provider images.
39
+
40
+
* The `stages` section defines the cloud-init stages that run during the node boot process. Stages defined here are processed in the same way as stages defined in a `user-data` file. Refer to the [Installer Reference Cloud Init Stages](https://docs.spectrocloud.com/clusters/edge/edge-configuration/installer-reference/#cloud-init-stages) for more information.
41
+
42
+
43
+
The following YAML configuration file example demonstrates how these sections are used, with inline comments describing all available fields.
44
+
45
+
```yaml
46
+
pack:
47
+
content:
48
+
images:
49
+
- image: '{{.spectro.pack.edge-native-byoi.options.system.uri}}'# This parameter uses the value set in the options section as the image for the pack.
50
+
# Uncomment the following parameters to change them. Otherwise, the pack uses the default values.
51
+
#drain:
52
+
#drainPods: auto # Drain pods during cluster upgrades. Set this value to false to skip draining.
53
+
#podSelector: # Specify the pod selector options for draining specific pods.
54
+
#cordon: true # Cordon the node before draining. This prevents new pods from being scheduled.
55
+
#timeout: 60 # Maximum time, in seconds, to wait for drain to complete. Set this value to 0 for no timeout.
56
+
#gracePeriod: 60 # Time, in seconds, allocated to each pod to terminate gracefully. Set this parameter to a negative value to use the pod's default time.
57
+
#ignoreDaemonSets: true # Ignore DaemonSet-managed pods during drain.
58
+
#deleteLocalData: true # Allow drain to proceed even if pods use emptyDir. This will delete local data.
59
+
#force: true # Force drain even if there are pods without controllers.
60
+
#disableEviction: false # Use delete instead of eviction, and bypass PodDisruptionBudgets. Use this parameter with caution.
61
+
#skipWaitForDeleteTimeout: 60 # Skip waiting for a pod if its DeletionTimestamp is older than this value (in seconds).
62
+
options:
63
+
system.uri: ""# The provider image URL for appliance mode. Set this value to the appliance's image location.
64
+
65
+
providerCredentials:
66
+
registry: example.com/spectro-images # The registry location for your provider images. This is prepended to the value in your options.system.uri setting.
67
+
user: user # The username for the registry.
68
+
password: "password"# The password for the registry.
69
+
certificates: | # The security certificate for the registry, in PEM format.
70
+
xxx
71
+
72
+
# Cloud init stages behave the same whether they are defined in the BYOOS pack or in user data.
73
+
stages:
74
+
initramfs: # Stage name, typically for early boot/initramfs operations.
75
+
- name: Test stage # The name of the step within the stage.
76
+
commands:
77
+
- echo "hello world" # The command to execute. Prints "hello world" for testing.
78
+
79
+
```
80
+
81
+
82
+
### Agent Mode
83
+
84
+
To enable agent mode with the BYOOS Edge OS pack, expand the **Presets** section from the YAML editor view. Toggle the
85
+
**Agent Mode** switch to enable agent mode. Check out the
86
+
[Install Palette Agent](../deployment-modes/agent-mode/install-agent-host.md) guide for additional guidance on
87
+
installing the Palette Agent.
88
+
89
+
</TabItem>
90
+
19
91
<TabItemlabel="2.0.x"value="2.0.x">
20
92
21
93
BYOOS enables you to use a custom OS for your Edge host. The custom OS must include all the Edge artifacts and provider
0 commit comments