Switching to the Direct
Mode
To switch an already running cluster to Direct
mode, follow these steps:
When changing the registry mode or registry parameters, Deckhouse will be restarted.
-
Before switching, perform the migration to use the
registry
module. -
Make sure the
registry
module is enabled and running. To do this, execute the following command:d8 k get module registry -o wide
Example output:
NAME WEIGHT ... PHASE ENABLED DISABLED MESSAGE READY registry 38 ... Ready True True
-
Make sure all master nodes are in the
Ready
state and do not have theSchedulingDisabled
status, using the following command:d8 k get nodes
Example output:
NAME STATUS ROLES ... master-0 Ready control-plane,master ... master-1 Ready control-plane,master ... master-2 Ready control-plane,master ...
Example of output when the master node (
master-2
in the example) is in theSchedulingDisabled
status:NAME STATUS ROLES ... master-0 Ready control-plane,master ... master-1 Ready control-plane,master ... master-2 Ready,SchedulingDisabled control-plane,master ...
-
Ensure the Deckhouse job queue is empty and contains no errors.
-
Set the
Direct
mode configuration in the ModuleConfigdeckhouse
. If you’re using a registry other thanregistry.deckhouse.ru
, refer to thedeckhouse
module documentation for correct configuration.Configuration example:
apiVersion: deckhouse.io/v1alpha1 kind: ModuleConfig metadata: name: deckhouse spec: version: 1 enabled: true settings: registry: mode: Direct direct: imagesRepo: registry.deckhouse.ru/deckhouse/ee scheme: HTTPS license: <LICENSE_KEY> # Replace with your license key
-
Check the registry switch status in the
registry-state
secret using this guide.Example output:
conditions: # ... - lastTransitionTime: "..." message: "" reason: "" status: "True" type: Ready hash: .. mode: Direct target_mode: Direct
Switching to the Unmanaged
Mode
To switch an already running cluster to Unmanaged
mode, follow these steps:
Changing the registry mode or its parameters will cause Deckhouse to restart.
-
Before switching, perform the migration to use the
registry
module. -
Make sure the
registry
module is enabled and running. To do this, execute the following command:d8 k get module registry -o wide
Example output:
NAME WEIGHT ... PHASE ENABLED DISABLED MESSAGE READY registry 38 ... Ready True True
-
Ensure the Deckhouse job queue is empty and contains no errors.
-
Set the
Unmanaged
mode configuration in the ModuleConfigdeckhouse
. If you’re using a registry other thanregistry.deckhouse.ru
, refer to thedeckhouse
module documentation for correct configuration.Configuration example:
apiVersion: deckhouse.io/v1alpha1 kind: ModuleConfig metadata: name: deckhouse spec: version: 1 enabled: true settings: registry: mode: Unmanaged unmanaged: imagesRepo: registry.deckhouse.ru/deckhouse/ee scheme: HTTPS license: <LICENSE_KEY> # Replace with your license key
-
Check the registry switch status in the
registry-state
secret using this guide.Example output:
conditions: # ... - lastTransitionTime: "..." message: "" reason: "" status: "True" type: Ready hash: .. mode: Unmanaged target_mode: Unmanaged
-
If you need to switch back to the old registry management method, refer to the instruction.
This is a deprecated format for registry management.