Skip to main content

hamctl

hamctl ابزاری برای مدیریت اپ‌ها در پلتفرم ابری دارکوب است. از طریق این ابراز می‌توانید اپ جدید بسازید، اپ‌های ساخته شده را مشاهده و آپدیت کنید.

نصب hamctl​

برای نصب hamctl می‌توانید از کامند زیر استفاده کنید. برای نصب hamctl از طریق کامند زیر نیاز دارید تا npm را بر روی سیستم خود نصب داشته باشید.

sudo npm i g hamctl

همچنین می‌توانید با مراجعه به صفحه‌‌ی releaseهای hamctl، با توجه به سیستم‌عامل و نسخه مورد نظر خود، اقدام به دانلود و استفاده از hamctl کنید.

دستورات​

hamctl login​

برای لاگین در حساب کاربری می‌توانید از نام‌کاربری و رمز عبور خود استفاده کنید و یا از صفحه‌‌ی Api Key اقدام به ایجاد یک API Key کنید و از آن برای ورود استفاده کنید. در ادامه مثال‌هایی از هر دو روش ورود به حساب کاربری مشاهده خواهیم کرد.

hamctl login
hamctl login -u|--username [username] -p|--password [password]

پس از ورود به حساب کاربری، اطلاعات شما در فایلی به نام .hamctlconfig، در مسیر ~ ذخیره می‌گردد.

hamctl logout​

برای خارج شدن از حساب کاربری خود تنها کافیست از دستور زیر استفاده کنید.

hamctl logout

hamctl organizations​

از طریق hamctl می‌توانید لیست سازمان‌هایی که ایجاد کرده‌اید و یا در آن‌ها عضو هستید را مشاهده کنید و یا سازمان پیشفرض در hamctl را تغییر دهید.

Aliasها: organization, orgs, org, o

hamctl organizations list
hamctl organizations switch

hamctl namespaces​

به جهت مشاهده namespaceهای ساخته شده و ایجاد namespace جدید می‌توانید از دستورهای زیر استفاده کنید.

Aliasها: namespace, ns, n

hamctl namespaces list
hamctl namespaces create

hamctl apps​

دستوری است که با استفاده از آن می‌توان اپ‌ها را مدیریت کرد.

Aliasها: app, a

مشاهده لیست اپ‌ها:​

hamctl apps list

ساخت اپ جدید:​

Flagها:

  • -n | --name نام اپ جدید

  • --namespace نام namespace

  • -c | --cluster نام کلاستر

  • -t | --type

    مقادیر قابل استفاده:

    docker-image github-repo hamgit-repo

    redis postgresql minio mysql mariadb mongodb elasticsearch mssql

    jira metabase grafana rabbitmq prometheus wordpress confluence rocketchat gitlab_runner kibana nextcloud

    static nodejs python php ruby go java dotnet

hamctl apps create --name [new-app-name] --namespace [namespace] --cluster [cluster] --type [type]

همچنین می‌توانید از دستور hamctl apps create به تنهایی استفاده کنید تا مراحل ایجاد اپ را به صورت interactive پیش ببرید.

حذف اپ​

Aliasها: del

Flagها:

  • -n | --name نام اپ
  • --namespace نام namespace
  • -c | --cluster نام کلاستر
hamctl apps delete [app-name] --namespace [namespace] --cluster [cluster]

مشاهده مشخصات اپ‌ها​

Aliasها: detail

hamctl apps details [app-name]

تغییر image اپ‌های داکری و گیت​

hamctl apps set-image [app-name] --image [image] --tag [tag]

غیرفعال کردن اپ​

hamctl apps stop [app-name] --namespace [namespace] --cluster [cluster]

فعال کردن اپ​

hamctl apps start [app-name] --namespace [namespace] --cluster [cluster]

*: به صورت پیشفرض از سازمانی استفاده می‌شود که آن را به عنوان سازمان پیشفرض تنظیم کرده‌اید.

توجه داشته باشید که hamctl در حال حاضر در مرحله تست می‌باشد. بنابراین اگر مشکل، انتقاد یا پیشنهادی در رابطه با hamctl دارید، آن را از طریق تیکت با تیم هم‌روش مطرح کنید.