Перейти до основного вмісту
Версія: 4.0.0

Посібник: Створення втулків CLI

Створіть команду helm system-info, яка виводить інформацію про систему.

Subprocess Runtime​

Почнемо з створення втулка CLI з середовищем виконання Subprocess.

Передумови​

  1. Встановіть останню версію Helm 4: v4.0.0
  2. У терміналі створіть аліас helm для завантаженої версії. Команда helm version --short повинна показати правильну версію Helm у цьому терміналі.

1. Створіть теку для втулка​

Ви можете створити її в будь-якому місці вашої файлової системи. Наприклад:

mkdir -p $HOME/code/helm/plugins/system-info
cd $HOME/code/helm/plugins/system-info

2. Створіть маніфест втулка​

plugin.yaml
apiVersion: v1
type: cli/v1
name: "system-info"
version: "0.1.0"
runtime: subprocess
config:
  usage: system-info
  shortHelp: Показує системну інформацію та інформацію Helm
  longHelp: Показує інформацію про ОС, версію Helm та деталі середовища
runtimeConfig:
  platformCommand:
    - command: ${HELM_PLUGIN_DIR}/system-info.sh

3. Створіть скрипт​

system-info.sh
#!/bin/bash

echo "=== System Information ==="
echo "OS: $(uname -s)"
echo "Architecture: $(uname -m)"

echo ""
echo "=== Helm Information ==="
echo "Plugin Dir: $HELM_PLUGIN_DIR"
echo "Arguments: $*"

echo ""
echo "System info complete!"

Зробіть його виконуваним:

chmod +x system-info.sh

4. Встановлення в режимі розробки та тестування​

Встановлення втулка з вашої файлової системи відбувається в локальному режимі розробки. Це дозволяє обійти перевірку або підтвердження походження:

% helm plugin install $HOME/code/helm/plugins/system-info
Installing plugin from local directory (development mode)
Installed plugin: system-info

Встановлення в локальному режимі розробки створює символічне посилання з вашого теки джерел до теки втулків, тому ви можете продовжувати розробку в бажаному місці. Ви можете побачити символічне посилання, переглянувши розташування теки за допомогою внутрішньої змінної середовища HELM_PLUGINS:

% ls -lah $(helm env HELM_PLUGINS)
total 0
drwxr-xr-x@ 3 r6by  staff    96B Nov 10 02:18 .
drwxr-xr-x@ 3 r6by  staff    96B Jan 21  2025 ..
lrwxr-xr-x  1 r6by  staff    41B Nov 10 02:18 system-info -> /Users/r6by/code/helm/plugins/system-info

Ви можете переглянути детальну інформацію про втулок у списку встановлених втулків helm plugin list:

% helm plugin list
NAME       	VERSION	TYPE  	APIVERSION	PROVENANCE	SOURCE
system-info	0.1.0  	cli/v1	v1        	local dev 	unknown

Тепер ви також можете побачити свій втулок у списку доступних команд за допомогою команди helm help і переглянути власне повідомлення довідки, яке ви визначили у файлі plugin.yaml:

% helm help | grep system-info
  system-info Показує системну інформацію та інформацію Helm

% helm help system-info
Показує інформацію про ОС, версію Helm та деталі середовища

Usage:
  helm system-info [flags]

Спробуємо запустити команду CLI:

% helm system-info
=== System Information ===
OS: Darwin
Architecture: arm64

=== Helm Information ===
Plugin Dir: /Users/r6by/Library/helm/plugins/system-info
Arguments:

System info complete!

Що ви створили: втулок CLI з використанням середовища виконання Subprocess!

Тепер давайте зробимо це ще раз, але цього разу з використанням середовища виконання Wasm…

Wasm Runtime​

Передумови​

попередження

To-do: додати цей розділ