نشر تنزيل deploy helper - نشر رمز المصدر deploy helper

deploy helper

شفرة المصدر الأخرى

1.0.0

تنزيل

نشر helper

يعد Deploy-Helper أداة صغيرة لنشر Artifact المستهدف لدى مطوري البرامج.

جدول المحتويات

متطلبات
غاية
عيوب
سمات
إعدادات
نائبة / متغيرات
الحجج
تثبيت
كيفية التشغيل (أمثلة)
بناء من المصدر
المساهمة

متطلبات

جافا 15!
Openssh (أو ما يعادلها) لجلسات SSH
- 'sshpass' إذا كنت تريد استخدام مصادقة كلمة مرور النص العادي

غاية

كتبت نشر Helper لمساعدتي في نشر القطع الأثرية على شبكة اختبار عندما أعمل على الأشياء. ربما كان بإمكاني استخدام IDE لذلك ، لكن هذا ليس ممتعًا!

خطوات دون نشر helper:

ترجمة
افتح ملفات الملفات
حذف قطعة أثرية قديمة من الخادم
سحب وإسقاط القطع الأثرية الجديدة إلى الخادم

خطوات مع النشر:

ترجمة
تشغيل نشر helper

عيوب

إنه مكتوب في جافا
ليس لديها الكثير من الميزات

سمات

وجهات النشر المتعددة
الأوامر المحلية
جلسة SSH

إعدادات

يجب أن يكون ملف التكوين الافتراضي deploy-helper.json في دليل العمل الخاص بك.
مثال على التكوين:

 {
  // Required
  "destinations" : [
    {
      // Name of the destination
      "name" : "service1" ,
      // Normally you would set a real address or a ip here,
      // but you could also use aliases from your ssh config (like I did here)
      "address" : "test-network" ,
      // The path for our destination (used for the ssh session)
      "path" : "/home/user/services/service1/data/" ,
      // SSH_COMMANDS (ssh first, then commands) or 
      // COMMANDS_SSH (commands first, then ssh)
      "order" : "SSH_COMMANDS"
    } ,
    {
      "name" : "service2" ,
      "address" : "test-network" ,
      "path" : "/home/user/services/service1/data/" ,
      "order" : "SSH_COMMANDS"
    }
  ] ,
  // Required
  "artifact" : {
    // Directory that contains the artifact
    "directory" : "./target" ,
    // Name regex that matches the artifact
    "name" : "my-software-[\d.A-Za-z-]+\.jar" ,
    // Sorting operation for possible artifacts
    // LAST_MODIFIED_ASC (oldest file first) or
    // LAST_MODIFIED_DESC (newest file first)
    "sort" : "LAST_MODIFIED_DESC"
  } ,
  // Optional
  "commands" : [
    // Can be either a string or an array of strings
    "scp {ARTIFACT_PATH} {SSH_USER}@{DEST_ADDRESS}:{DEST_PATH}{ARTIFACT_NAME}"
  ] ,
  // Optional
  "ssh" : {
    // If port is > 0, the ssh command will be USER@HOST:PORT
    // If the port is <= 0, the ssh command will be USER@HOST
    "port" : 0 ,
    // How long to wait for the connection to establish
    "sleep" : "2000" ,
    // The ssh user
    "user" : "user" ,
    // Plaintext password auth requires 'sshpass'
    // "password": "foobar",
    "commands" : [
      // Commands have to be a string
      "rm my-software-*.jar"
    ]
  }
}

هذا المثال التكوين يفعل ما يلي:

ابدأ جلسة SSH
قم بتشغيل أمر rm لحذف القطع الأثرية القديمة
خروج جلسة SSH
قم بتشغيل أمر scp لنسخ قطعة أثرية جديدة إلى الخادم

يجب عليك أيضًا إضافة deploy-helper.json إلى ملف .gitignore الخاص بك.

ملاحظة: يمكن أن يكون هناك قطعة أثرية واحدة فقط.

نائبة / متغيرات

{DEST_ADDRESS} : عنوان الوجهة
{DEST_NAME} : اسم الوجهة
{DEST_PATH} : مسار الوجهة
{SSH_USER} : مستخدم SSH
{SSH_PORT} : منفذ SSH
{ARTIFACT_PATH} : مسار Artifact
{ARTIFACT_NAME} : اسم قطعة أثرية

الحجج

طويل	قصير	وصف
--Config	-C	تجاوز موقع التكوين
-فيربوز	-v	إذا تم تمكين ، فسيتم إعادة توجيه إخراج العملية إلى stdout & stderr
--وجهة	-D	تجاوز الوجهات (القائمة الفاصلة الفاصلة)

تثبيت

يعد تثبيت Deploy-Helper سهلاً مثل تنزيل الجرة من الإصدار الأخير (من الناحية النظرية). ومع ذلك ، ربما يجب أن تبقي الجرة في نوع من الموقع المركزي.

هذه هي الطريقة التي قمت بتثبيتها على جهاز Helper على جهاز Linux الخاص بي مع ZSH:

sudo mkdir /opt/deploy-helper
sudo chown max:max /opt/deploy-helper
mv ~/Downloads/deploy-helper-*.jar /opt/deploy-helper
echo "alias deploy='java --enable-preview -jar /opt/deploy-helper/deploy-helper-VERSION.jar'" >> ~/.zshrc

ثم ببساطة إعادة فتح المحطة الخاصة بك (أو source ~/.zshrc ) وأنت تنتهي!