fluent package builder

منشئ الحزم بطلاقة

حول منشئ الحزم بطلاقة

Fluent-package-builder (المعروف سابقًا باسم td-agent-builder، تمت إعادة تسميته في أغسطس 2021) هو نظام إنشاء جديد لـ td-agent والذي يهدف إلى استبدال نظام البناء التقليدي omnibus-td-agent نظرًا لأنه يعاني من العديد من المشكلات بسبب قيود Omnibus.

ملحوظة: تمت مناقشة سبب ضرورة إعادة العلامة التجارية إعادة تسمية العلامة التجارية td-agent-builder

التغييرات من وكيل الكنز 4

• تمت إعادة تسمية td-agent إلى fluent-package
  • تم تغيير محتوى fluent-package ليتم تثبيتها ضمن /opt/fluent
  • تم تغيير /usr/sbin/td-agent و /usr/sbin/td-agent-gem إلى /usr/sbin/fluentd و /usr/sbin/fluent-gem
  • تم تغيير مسار مثال ملف التكوين الافتراضي إلى /opt/fluent/share/fluentd.conf
• تم دعم دبيان 12 (دودة الكتب).
• تمت إزالة دعم Ubuntu 16.04 (xenial) وUbuntu 18.04 (bionic)
• تم دعم Amazon Linux 2023
• تم تقديم مفتاح توقيع الحزمة الجديد. سيتم استخدام المفتاح الجديد في الإصدار المستقبلي. ما زلنا نستخدم استخدام مفتاح التوقيع القديم لفترة من الوقت
• تمت إعادة تسمية fluentd-apt-source إلى حزمة deb fluent-apt-source للحفاظ على apt-line وحلقة المفاتيح

التغييرات من وكيل الكنز 3

• استخدم مكتبات النظام: على سبيل المثال opensl
• قم بإزالة المكتبات الخاصة بجواهر الطرف الثالث: على سبيل المثال postgresql
• قم بإزالة الدليل embedded بواسطة Omnibus
  • استخدم /opt/td-agent/bin/fluent-cat بدلاً من /opt/td-agent/embedded/bin/fluent-cat
• تحديث المكونات الأساسية: Ruby وjemalloc والمزيد
• أضف حزمة deb td-agent-apt-source للحفاظ على apt-line وحلقة المفاتيح
  • قم بتنزيله وتثبيته عن طريق apt install ، ثم يمكنك تثبيت td-agent عبر apt install td-agent .
  • يتم إنشاء حزمة deb td-agent-apt-source لتثبيت td-agent بسهولة. يشير حاليًا إلى td-agent 4 apt-line.

راجع أيضًا هذه المشكلة للتعرف على المشكلات الشاملة.

المتطلبات الأساسية

لبناء حزم .rpm و.deb

• أي نظام تشغيل مضيف يدعمه Docker
  • يوصى باستخدام Debian Buster أو Ubuntu 18.04
• عامل ميناء
• روبي 2.5 أو الأحدث
• Bundler 2.2.0 أو الأحدث
• بوابة

لبناء حزمة Windows (.msi)

• نظام التشغيل Windows (تم التحقق من الإصدار 10 Pro أو 2019)
• سطح المكتب دوكر لنظام التشغيل Windows
  • تحتاج إلى التبديل إلى "حاويات Windows" قبل استخدامه.
• RubyInstaller 2.5 أو الأحدث.
• Bundler 2.2.0 أو الأحدث
• جيت لنظام التشغيل Windows

بعد تثبيت البرنامج أعلاه، تحتاج إلى تمكين ميزات إضافية من بوويرشيل (كمسؤول).

 dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart
dism.exe /online /enable-feature /featurename:Containers /all /norestart

ثم أعد تشغيل الويندوز.

لبناء حزمة macOS (.dmg)

• ماك 10.15 (كاتالينا)
• روبي 2.5 أو الأحدث
• Bundler 2.2.0 أو الأحدث
• جوهرة البناء
• بوابة
• CMake
• الصدأ لتمكين ميزة YJIT الخاصة بـ Ruby

كيفية بناء حزمة دورة في الدقيقة

% rake yum:build

افتراضيًا، سيتم إنشاء مستودعات yum للمنصات التالية ضمن دليل Fluent-package/yum/repositories/:

• RHEL/CentOS 8 (x86_64) - مبني على Rocky Linux 8
• RHEL/CentOS 9 (x86_64) - مبني على AlmaLinux 9
• أمازون لينكس 2 (x86_64)
• أمازون لينكس 2023 (x86_64)

يمكنك اختيار الأنظمة الأساسية المستهدفة حسب متغير البيئة YUM_TARGETS مثل هذا:

% rake yum:build YUM_TARGETS= " rockylinux-8,almalinux-9 "

يمكنك العثور على منصات أخرى مدعومة ضمن دليل Fluent-package/yum.

ملاحظة لمنصات AArch64

يمكنك أيضًا إنشاء حزم لمنصات AArch64 مثل هذا:

% rake yum:build YUM_TARGETS= " amazonlinux-2023-aarch64 "

لكن إذا كنت تستخدم منصات GNU/Linux الأقدم (مثل Ubuntu 18.04 أو قبله) كنظام التشغيل المضيف لديك، فستحتاج إلى نسخ qemu-aarch64-static إلى الدليل الأساسي للهدف:

% export TARGET_BASE= " centos-8 "
% sudo apt install qemu-user-static
% cd /path/to/fluent-package-builder
% cp /usr/bin/qemu-aarch64-static fluent-package/yum/ ${TARGET_BASE}
% rake yum:build YUM_TARGETS= " ${TARGET_BASE} -aarch64 "

ملاحظة لمنصة ppc64le

يمكنك أيضًا إنشاء حزم لمنصة ppc64le مثل هذا:

% rake yum:build YUM_TARGETS= " centos-8-ppc64le "

لكن إذا كنت تستخدم منصات GNU/Linux الأقدم (مثل Ubuntu 18.04 أو قبله) كنظام التشغيل المضيف لديك، فستحتاج إلى نسخ qemu-ppc64le-static إلى الدليل الأساسي للهدف:

% export TARGET_BASE= " centos-8 "
% sudo apt install qemu-user-static
% cd /path/to/fluent-package-builder
% cp /usr/bin/qemu-ppc64le-static fluent-package/yum/ ${TARGET_BASE}
% rake yum:build YUM_TARGETS= " ${TARGET_BASE} -ppc64le " 

كيفية بناء حزمة .deb

% rake apt:build

افتراضيًا، سيتم إنشاء مستودعات apt للمنصات التالية ضمن دليل Fluent-package/apt/repositories/:

• ديبيان 11 "عين الهدف" (x86_64)
• ديبيان 12 "دودة الكتب" (x86_64)
• أوبونتو 20.04 LTS "الحفرة البؤرية" (x86_64)
• أوبونتو 22.04 LTS "جامي قنديل البحر" (x86_64)
• أوبونتو 24.04 LTS "نوبل نومبات" (x86_64)

يمكنك اختيار الأنظمة الأساسية المستهدفة عن طريق متغير البيئة APT_TARGETS مثل هذا:

% rake apt:build APT_TARGETS= " debian-bookworm,ubuntu-jammy "

يمكنك العثور على منصات أخرى مدعومة ضمن دليل Fluent-package/apt.

ملاحظة لمنصات AArch64

يمكنك أيضًا إنشاء حزم لمنصات AArch64 مثل هذا:

% rake apt:build APT_TARGETS= " ubuntu-jammy-arm64 "

لكن إذا كنت تستخدم منصات GNU/Linux الأقدم (مثل Ubuntu 18.04 أو قبله) كنظام التشغيل المضيف لديك، فستحتاج إلى نسخ qemu-aarch64-static إلى الدليل الأساسي للهدف:

% export TARGET_BASE= " ubuntu-bionic "
% sudo apt install qemu-user-static
% cd /path/to/fluent-package-builder
% cp /usr/bin/qemu-aarch64-static fluent-package/apt/ ${TARGET_BASE}
% rake apt:build APT_TARGETS= " ${TARGET_BASE} -arm64 " 

كيفية بناء حزمة .msi

% rake msi:build

سيتم إنشاء حزمة Fluent-package-${version}-x64.msi ضمن دليل Fluent-package/msi.

ملاحظة لحزمة Windows

يمكنك استخدامه مع MSYS2 لبناء الأحجار الكريمة ذات ملحق C.

يمكن لـ MSI المتضمن Ruby اكتشاف بيئة MSYS2. لذلك، يمكنك تثبيت جوهرة C المضمنة مع MSYS2.

على سبيل المثال)

إعداد بيئة بناء جوهرة ملحق C:

 cmd> ridk install 2
...
cmd> ridk install 3

قم بتثبيت الجوهرة عبر ridk exec fluent-gem install :

 cmd> ridk exec fluent-gem install winevt_c 

كيفية بناء حزمة .dmg

% sudo mkdir /opt/fluent
% sudo chown $( whoami ) /opt/fluent
% rake dmg:selfbuild

سيتم إنشاء حزمة Fluent-package-${version}.dmg ضمن دليل Fluent-package/dmg.

ملاحظة لحزمة macOS

الحزمة المضمنة لـ GitHub Actions جاهزة للتشغيل على نظام التشغيل macOS 10.15 (Catalina).

تأكد من السماح لك بالوصول المساعد. في تفضيلات النظام > الأمان والخصوصية > الخصوصية > إمكانية الوصول، يجب عليك السماح بـ Terminal.app هناك.

ملاحظة: بما أن الترخيص موجود على مستوى التطبيق على Terminal.app، فإنه يسمح لأي برنامج نصي يتم تشغيله من Terminal.app بتنفيذ البرمجة النصية لواجهة المستخدم الرسومية.

كيفية رفع إصدار الحزمة

• قم بتحرير Fluent-package/config.rb لاختيار إصدارات Ruby وFluentd
• تحرير Gemfile وتحديث ملفات .lock
  • cd fluent-package && rake lockfile:update
• قم بزيادة إصدارات حزم rpm & deb عن طريق الأمر التالي:

 % cd fluent-package
% rake version:update
% git diff  # Check the change log
% git commit -a

• بناء الحزم

 % rake apt:build
% rake yum:build
% rake msi:build

ملاحظة لرفع إصدار الحزمة

يفترض أن Gemfile يعمل مع ميزة الأنظمة الأساسية المتعددة لـ Bundler، لذلك يجب أن يكون إصدار المجمع 2.2.0 أو أحدث.