symlink

func (*Installer) Install ¶

func (i *Installer) Install(ctx context.Context, module, version, tempModulePath string) error

Install copies a module from temp location to permanent storage and creates symlink. Process:

1. Create /deckhouse/downloaded/<module>/ directory
2. Remove old module version if exists(atomic update)
3. Copy module files from tempModulePath to permanent location
4. Remove old symlink if exists (atomic update)
5. Create new symlink: /deckhouse/downloaded/<module> -> /deckhouse/downloaded/modules/<version>

func (*Installer) Restore ¶

func (i *Installer) Restore(ctx context.Context, ms *v1alpha1.ModuleSource, module, version string) error

Restore downloads a module from registry and creates symlink. Used for recovering modules after restart or failure. Process:

1. Create /deckhouse/downloaded/<module>/ directory
2. Remove old symlink if exists
3. Download module from registry
4. Create symlink: /deckhouse/downloaded/<module> -> /deckhouse/downloaded/modules/<version>

func (*Installer) Stage ¶ added in v1.76.3

func (i *Installer) Stage(ctx context.Context, module, version, tempModulePath string) error

Stage copies a module from temp location to permanent storage WITHOUT creating the symlink. The files end up at /deckhouse/downloaded/<module>/<version>/ but the module is not exposed to the operator, so an embedded copy of the same name keeps serving the module. The symlink is created later (by Install/Restore) once the embedded copy is gone.

func (*Installer) StageFromRegistry ¶ added in v1.76.3

func (i *Installer) StageFromRegistry(ctx context.Context, ms *v1alpha1.ModuleSource, module, version string) error

StageFromRegistry downloads a module from the registry to permanent storage WITHOUT creating the symlink. Mirrors Restore but skips activation.

func (*Installer) Uninstall ¶

func (i *Installer) Uninstall(ctx context.Context, module string) error

Uninstall removes module symlink and cleans up module files. Process:

1. Check if symlink exists (returns early if not)
2. Explicitly remove symlink
3. Defer: Remove entire module directory /deckhouse/downloaded/<module>

Two-phase cleanup ensures symlink is removed before directory cleanup