หน้านี้จะอธิบายวิธีกำหนดกฎของที่เก็บและแสดงตัวอย่างเพื่อดูรายละเอียดเพิ่มเติม
ที่เก็บภายนอกเป็นแผนผังไดเรกทอรีซึ่งมีไฟล์แหล่งที่มาที่ใช้งานได้ในบิลด์ของ Bazel ซึ่งสร้างขึ้นตามคำขอโดยเรียกใช้กฎที่เก็บที่เกี่ยวข้อง คุณสามารถกำหนดที่เก็บได้หลายวิธี แต่ท้ายที่สุดแล้ว แต่ละที่เก็บจะกำหนดโดยการเรียกใช้กฎที่เก็บ เช่นเดียวกับการกำหนดเป้าหมายการสร้างโดยการเรียกใช้กฎการสร้าง สามารถใช้เพื่อใช้ไลบรารีของบุคคลที่สาม (เช่น ไลบรารีที่แพ็กเกจ Maven) และสร้างไฟล์ BUILD
สำหรับโฮสต์ที่ Bazel ทำงานอยู่โดยเฉพาะ
คําจํากัดความของกฎที่เก็บ
ในไฟล์ .bzl
ให้ใช้ฟังก์ชัน repository_rule เพื่อกำหนดกฎใหม่ของที่เก็บและจัดเก็บไว้ในตัวแปรส่วนกลาง หลังจากกำหนดกฎของ repo แล้ว คุณจะเรียกใช้กฎดังกล่าวเป็นฟังก์ชันเพื่อกำหนด repo ได้ การเรียกใช้นี้มักจะดำเนินการจากภายในฟังก์ชันการใช้งานส่วนขยายโมดูล
องค์ประกอบหลัก 2 อย่างของคำจำกัดความกฎที่เก็บคือสคีมาแอตทริบิวต์และฟังก์ชันการใช้งาน สคีมาแอตทริบิวต์จะกำหนดชื่อและประเภทแอตทริบิวต์ที่ส่งไปยังการเรียกใช้กฎของรีโป และระบบจะเรียกใช้ฟังก์ชันการใช้งานเมื่อต้องดึงข้อมูลรีโป
Attributes
แอตทริบิวต์คืออาร์กิวเมนต์ที่ส่งไปยังการเรียกใช้กฎของรีโป สคีมาของแอตทริบิวต์ที่กฎของรีโปยอมรับจะระบุโดยใช้อาร์กิวเมนต์ attrs
เมื่อมีการกําหนดกฎของรีโปด้วยการเรียกใช้ repository_rule
ตัวอย่างการกำหนดแอตทริบิวต์ url
และ sha256
เป็นสตริง
http_archive = repository_rule(
implementation=_impl,
attrs={
"url": attr.string(mandatory=True),
"sha256": attr.string(mandatory=True),
}
)
หากต้องการเข้าถึงแอตทริบิวต์ภายในฟังก์ชันการใช้งาน ให้ใช้ repository_ctx.attr.<attribute_name>
ดังนี้
def _impl(repository_ctx):
url = repository_ctx.attr.url
checksum = repository_ctx.attr.sha256
repository_rule
ทั้งหมดมีแอตทริบิวต์ name
ที่กําหนดโดยนัย นี่คือแอตทริบิวต์สตริงที่ทำงานอย่างน่าอัศจรรย์ เมื่อระบุเป็นอินพุตในการเรียกใช้กฎของ repo ระบบจะใช้ชื่อ repo ที่ปรากฏ แต่เมื่ออ่านจากฟังก์ชันการใช้งานของกฎ repo โดยใช้ repository_ctx.attr.name
ระบบจะแสดงชื่อ repo ที่เป็น Canonical
ฟังก์ชันการใช้งาน
กฎของ repo แต่ละข้อต้องมีฟังก์ชัน implementation
ซึ่งมีตรรกะจริงของกฎและจะทำงานในขั้นตอนการโหลดอย่างเคร่งครัด
ฟังก์ชันมีพารามิเตอร์อินพุต repository_ctx
เพียง 1 รายการ ฟังก์ชันจะแสดงผล None
เพื่อระบุว่าสร้างกฎซ้ำได้โดยใช้พารามิเตอร์ที่ระบุ หรือแสดงผล Dict ที่มีชุดพารามิเตอร์สําหรับกฎที่จะเปลี่ยนกฎนั้นให้สร้างซ้ำได้ซึ่งจะสร้าง repo เดียวกัน ตัวอย่างเช่น สำหรับกฎที่ติดตามที่เก็บ Git ซึ่งนั่นหมายถึงการส่งคืนตัวระบุคอมมิตที่เจาะจงแทนที่จะเป็น Branch แบบลอยที่มีการระบุไว้แต่แรก
พารามิเตอร์อินพุต repository_ctx
ใช้เพื่อเข้าถึงค่าแอตทริบิวต์และฟังก์ชันที่ไม่ใช่แบบปิด (การค้นหาไบนารี การดำเนินการไบนารี การสร้างไฟล์ในที่เก็บ หรือการดาวน์โหลดไฟล์จากอินเทอร์เน็ต) ได้ ดูบริบทเพิ่มเติมได้ในเอกสารประกอบของ API ตัวอย่าง
def _impl(repository_ctx):
repository_ctx.symlink(repository_ctx.attr.path, "")
local_repository = repository_rule(
implementation=_impl,
...)
ฟังก์ชันการติดตั้งใช้งานจะทํางานเมื่อใด
ระบบจะเรียกใช้ฟังก์ชันการใช้งานของกฎรีโปเมื่อ Bazel ต้องการเป้าหมายจากรีโปนั้น เช่น เมื่อเป้าหมายอื่น (ในรีโปอื่น) ขึ้นอยู่กับเป้าหมายนั้น หรือมีการกล่าวถึงเป้าหมายนั้นในบรรทัดคำสั่ง จากนั้นฟังก์ชันการติดตั้งใช้งานจะสร้างที่เก็บในระบบไฟล์ การดำเนินการนี้เรียกว่า "การดึงข้อมูล" รีโป
ซึ่งแตกต่างจากเป้าหมายปกติตรงที่ไม่จำเป็นต้องดึงข้อมูลรีโปอีกครั้งเมื่อมีการเปลี่ยนแปลงที่อาจทําให้รีโปแตกต่างออกไป ทั้งนี้เพราะมีบางอย่างที่ Bazel ตรวจไม่พบการเปลี่ยนแปลง หรืออาจก่อให้เกิดค่าใช้จ่ายมากเกินไปในทุกบิลด์ (เช่น สิ่งที่ดึงมาจากเครือข่าย) ดังนั้น ระบบจะดึงข้อมูลรีพอยต์อีกครั้งก็ต่อเมื่อมีการเปลี่ยนแปลงอย่างใดอย่างหนึ่งต่อไปนี้
- แอตทริบิวต์ที่ส่งไปยังการเรียกใช้กฎของ repo
- โค้ด Starlark ที่ประกอบด้วยการใช้งานกฎของพื้นที่เก็บข้อมูล
- ค่าของตัวแปรสภาพแวดล้อมที่ส่งไปยังเมธอด
getenv()
ของrepository_ctx
หรือประกาศด้วยแอตทริบิวต์environ
ของrepository_rule
ค่าของตัวแปรสภาพแวดล้อมเหล่านี้สามารถกำหนดค่าในบรรทัดคำสั่งได้โดยใช้แฟล็ก--repo_env
- สถานะ เนื้อหา และประเภทของเส้นทางที่
watch
ในฟังก์ชันการใช้งานของกฎรีโป- วิธีการอื่นๆ บางวิธีของ
repository_ctx
ที่มีพารามิเตอร์watch
เช่นread()
,execute()
และextract()
อาจทําให้ระบบติดตามเส้นทางด้วย - ในทํานองเดียวกัน
repository_ctx.watch_tree
และpath.readdir
อาจทําให้ระบบติดตามเส้นทางด้วยวิธีอื่นๆ
- วิธีการอื่นๆ บางวิธีของ
- เมื่อมีการเรียกใช้
bazel fetch --force
repository_rule
มี 2 พารามิเตอร์ที่ควบคุมเวลาในการดึงข้อมูลพื้นที่เก็บข้อมูลอีกครั้ง ดังนี้
- หากตั้งค่า Flag
configure
ระบบจะดึงข้อมูลพื้นที่เก็บข้อมูลอีกครั้งในbazel fetch --force --configure
(ระบบจะไม่ดึงข้อมูลพื้นที่เก็บข้อมูลที่ไม่ใช่configure
อีกครั้ง) - หากตั้งค่า Flag
local
ไว้ นอกเหนือจากกรณีที่ระบุไว้ข้างต้น ระบบจะดึงข้อมูลรีโปอีกครั้งเมื่อเซิร์ฟเวอร์ Bazel รีสตาร์ท
การบังคับให้ดึงข้อมูลที่เก็บภายนอกอีกครั้ง
บางครั้งที่เก็บภายนอกอาจล้าสมัยโดยไม่มีการเปลี่ยนแปลงคำจำกัดความหรือทรัพยากร Dependency เลย ตัวอย่างเช่น รีโปที่ดึงข้อมูลแหล่งที่มาอาจติดตามสาขาที่เฉพาะเจาะจงของที่เก็บข้อมูลของบุคคลที่สาม และคอมมิตใหม่จะอยู่ในสาขานั้น ในกรณีนี้ คุณสามารถขอให้ Bazel ดึงข้อมูลรีโพสิทอรี่ภายนอกทั้งหมดอีกครั้งโดยไม่มีเงื่อนไขได้ด้วยการเรียกใช้ bazel fetch --force --all
นอกจากนี้ กฎของรีโปบางรายการจะตรวจสอบเครื่องในเครื่องและอาจล้าสมัยหากมีการอัปเกรดเครื่องในเครื่อง ในส่วนนี้ คุณสามารถขอให้ Bazel ดึงข้อมูลรีพอสภายนอกที่คำจำกัดความ repository_rule
มีการตั้งค่าแอตทริบิวต์ configure
อีกครั้งเท่านั้นได้โดยใช้ bazel fetch --force
--configure
ตัวอย่าง
เครื่องมือทางเทคนิคที่กําหนดค่า C++ โดยอัตโนมัติ: ใช้กฎของพื้นที่เก็บข้อมูลเพื่อสร้างไฟล์การกําหนดค่า C++ สําหรับ Bazel โดยอัตโนมัติโดยมองหาคอมไพเลอร์ C++ ในพื้นที่ สภาพแวดล้อม และ Flag ที่คอมไพเลอร์ C++ รองรับ
ที่เก็บ Go ใช้
repository_rule
หลายรายการเพื่อกำหนดรายการของ Dependency ที่จำเป็นต้องใช้กฎ Gorules_jvm_external จะสร้างที่เก็บข้อมูลภายนอกชื่อ
@maven
โดยค่าเริ่มต้น ซึ่งจะสร้างเป้าหมายการสร้างสำหรับอาร์ติแฟกต์ Maven ทั้งหมดในต้นไม้การพึ่งพาแบบทรานซิทีฟ