สร้างแพ็คเกจได้อย่างคล่องแคล่ว

ผู้สร้างแพ็คเกจได้อย่างคล่องแคล่ว

เกี่ยวกับ Fluent-Package-Builder

fluent-package-builder (เดิมชื่อ td-agent-builder เปลี่ยนชื่อเมื่อเดือนสิงหาคม 2564) เป็นระบบบิลด์ใหม่สำหรับ td-agent ซึ่งมีจุดมุ่งหมายเพื่อแทนที่ระบบบิลด์แบบเดิม omnibus-td-agent เนื่องจากมีปัญหาหลายประการ เนื่องจากข้อจำกัดของ Omnibus

หมายเหตุ: อภิปรายว่าเหตุใดจึงจำเป็นต้องมีการสร้างแบรนด์ใหม่ การสร้างแบรนด์ใหม่ td-agent-builder

การเปลี่ยนแปลงจาก Treasure Agent 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
• รองรับ Debian 12 (หนอนหนังสือ) แล้ว
• ลบการสนับสนุน Ubuntu 16.04 (xenial), Ubuntu 18.04 (ไบโอนิค)
• รองรับ Amazon Linux 2023 แล้ว
• แนะนำคีย์การลงนามแพ็คเกจใหม่ คีย์ใหม่จะถูกใช้ในรุ่นต่อๆ ไป เรายังคงใช้คีย์การลงนามแบบเก่าอยู่พักหนึ่ง
• fluentd-apt-source ถูกเปลี่ยนชื่อเป็นแพ็คเกจ deb fluent-apt-source สำหรับการบำรุงรักษา apt-line และพวงกุญแจ

การเปลี่ยนแปลงจาก Treasure Agent 3

• ใช้ไลบรารีระบบ: เช่น openssl
• ลบไลบรารีสำหรับอัญมณีบุคคลที่สาม: เช่น postgresql
• ลบไดเร็กทอรี embedded โดยรถโดยสาร
  • ใช้ /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 หรือใหม่กว่า
• บันเดิล 2.2.0 หรือใหม่กว่า
• คอมไพล์

สำหรับการสร้างแพ็คเกจ Windows (.msi)

• Windows OS (10 Pro หรือ 2019 ได้รับการตรวจสอบแล้ว)
• นักเทียบท่าเดสก์ท็อปสำหรับ Windows
  • คุณต้องเปลี่ยนไปใช้ "คอนเทนเนอร์ Windows" ก่อนใช้งาน
• RubyInstaller 2.5 หรือใหม่กว่า
• บันเดิล 2.2.0 หรือใหม่กว่า
• คอมไพล์สำหรับ Windows

หลังจากติดตั้งซอฟต์แวร์ด้านบนแล้ว คุณจะต้องเปิดใช้งานคุณสมบัติเพิ่มเติมจาก PowerShell (ในฐานะผู้ดูแลระบบ)

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

จากนั้นรีสตาร์ท Windows

สำหรับการสร้างแพ็คเกจ macOS (.dmg)

• macOS 10.15 (คาตาลินา)
• รูบี้ 2.5 หรือใหม่กว่า
• บันเดิล 2.2.0 หรือใหม่กว่า
• อัญมณีผู้สร้าง
• คอมไพล์
• ซีเมค
• Rust เพื่อเปิดใช้งานคุณสมบัติ YJIT ของ Ruby

วิธีสร้างแพ็คเกจ .rpm

% 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)
• Ubuntu 20.04 LTS "โฟกัส Fossa" (x86_64)
• Ubuntu 22.04 LTS "Jammy แมงกะพรุน" (x86_64)
• Ubuntu 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 ที่รวม gem ด้วย MSYS2 ได้

เช่น)

เตรียมสภาพแวดล้อมการสร้างอัญมณีส่วนขยาย C:

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

ติดตั้ง gem ผ่าน 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 ดำเนินการเขียนสคริปต์ GUI ได้

วิธีชนรุ่นแพ็คเกจ

• แก้ไข 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 ดังนั้น Bundler ต้องเป็น 2.2.0 หรือใหม่กว่า