หน้านี้ได้รับการแปลโดย Cloud Translation API

หัวข้อขั้นสูงเกี่ยวกับทรัพยากร Dependency ภายนอก

การแก้ไขทรัพยากร Dependency ใน WORKSPACE

หากเป็นไปได้ ควรมีนโยบายเวอร์ชันเดียวในโปรเจ็กต์ของคุณ ซึ่งจำเป็นสำหรับทรัพยากร Dependency ที่คุณคอมไพล์และนำไปรวมไว้ในไบนารีสุดท้าย สำหรับกรณีอื่นๆ คุณสามารถใส่เงาทรัพยากร Dependency ได้ ดังนี้

โปรเจ็กต์ของฉัน/พื้นที่ทำงาน

workspace(name = "myproject")

local_repository(
    name = "A",
    path = "../A",
)
local_repository(
    name = "B",
    path = "../B",
)

A/WORKSPACE

workspace(name = "A")

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
    name = "testrunner",
    urls = ["https://github.com/testrunner/v1.zip"],
    sha256 = "...",
)

B/พื้นที่ทำงาน

workspace(name = "B")

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
    name = "testrunner",
    urls = ["https://github.com/testrunner/v2.zip"],
    sha256 = "..."
)

ทั้งทรัพยากร Dependency A และ B อิงตาม testrunner เวอร์ชันที่แตกต่างกัน รวมทั้ง 2 อย่างใน myproject โดยไม่ขัดแย้งกันโดยตั้งชื่อที่แตกต่างกันใน myproject/WORKSPACE:

workspace(name = "myproject")

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
    name = "testrunner-v1",
    urls = ["https://github.com/testrunner/v1.zip"],
    sha256 = "..."
)
http_archive(
    name = "testrunner-v2",
    urls = ["https://github.com/testrunner/v2.zip"],
    sha256 = "..."
)
local_repository(
    name = "A",
    path = "../A",
    repo_mapping = {"@testrunner" : "@testrunner-v1"}
)
local_repository(
    name = "B",
    path = "../B",
    repo_mapping = {"@testrunner" : "@testrunner-v2"}
)

คุณยังใช้กลไกนี้เพื่อรวมเพชรได้ด้วย ตัวอย่างเช่น หาก A และ B มีทรัพยากร Dependency เดียวกันแต่เรียกใช้ด้วยชื่ออื่น ให้ผนวกทรัพยากร Dependency เหล่านั้นใน myproject/WORKSPACE

การลบล้างที่เก็บจากบรรทัดคำสั่ง

หากต้องการลบล้างที่เก็บที่ประกาศด้วยที่เก็บในเครื่องจากบรรทัดคำสั่ง ให้ใช้แฟล็ก --override_repository การใช้แฟล็กนี้จะเปลี่ยนแปลงเนื้อหาของที่เก็บภายนอกโดยไม่เปลี่ยนซอร์สโค้ด

เช่น หากต้องการลบล้าง @foo ไปยังไดเรกทอรีในเครื่อง /path/to/local/foo ให้ส่งแฟล็ก --override_repository=foo=/path/to/local/foo

กรณีการใช้งานมีดังนี้

การแก้ปัญหา เช่น การลบล้างที่เก็บ http_archive ไปยังไดเรกทอรีในเครื่องที่คุณทำการเปลี่ยนแปลงได้ง่ายขึ้น
ตัวแทนจำหน่ายรายย่อย หากคุณอยู่ในสภาพแวดล้อมที่คุณเรียกใช้เครือข่ายไม่ได้ ให้ลบล้างกฎที่เก็บตามเครือข่ายเพื่อชี้ไปยังไดเรกทอรีในเครื่องแทน

การใช้พร็อกซี

Bazel รับที่อยู่พร็อกซีจากตัวแปรสภาพแวดล้อม HTTPS_PROXY และ HTTP_PROXY และใช้ตัวแปรเหล่านี้เพื่อดาวน์โหลดไฟล์ HTTP และ HTTPS (หากระบุ)

รองรับ IPv6

Bazel จะดาวน์โหลดทรัพยากร Dependency ได้โดยไม่มีการเปลี่ยนแปลงในเครื่องที่ใช้ IPv6 เท่านั้น อย่างไรก็ตาม สำหรับเครื่อง IPv4/IPv6 แบบ 2 สแต็ก Bazel ใช้รูปแบบเดียวกันกับ Java โดยแนะนำให้ใช้ IPv4 หากเปิดใช้ ในบางสถานการณ์ ตัวอย่างเช่น เมื่อเครือข่าย IPv4 แก้ไข/เข้าถึงที่อยู่ภายนอกไม่ได้ อาจทำให้เกิดข้อยกเว้น Network unreachable รายการและบิลด์ล้มเหลว ในกรณีเหล่านี้ คุณลบล้างลักษณะการทำงานของ Bazel เพื่อต้องการใช้ IPv6 ได้โดยใช้พร็อพเพอร์ตี้ระบบ java.net.preferIPv6Addresses=true กล่าวอย่างเจาะจงคือ

ใช้ตัวเลือกเริ่มต้น --host_jvm_args=-Djava.net.preferIPv6Addresses=true เช่น โดยการเพิ่มบรรทัดต่อไปนี้ในไฟล์ .bazelrc

startup --host_jvm_args=-Djava.net.preferIPv6Addresses=true
เมื่อเรียกใช้เป้าหมายของบิลด์ Java ที่ต้องเชื่อมต่อกับอินเทอร์เน็ต (เช่น เพื่อการทดสอบการผสานรวม) ให้ใช้ธงสถานะเครื่องมือ --jvmopt=-Djava.net.preferIPv6Addresses=true ตัวอย่างเช่น ใส่ข้อมูลต่อไปนี้ในไฟล์ .bazelrc

build --jvmopt=-Djava.net.preferIPv6Addresses
หากคุณใช้ rules_jvm_external สำหรับความละเอียดของเวอร์ชันทรัพยากร Dependency ให้เพิ่ม -Djava.net.preferIPv6Addresses=true ลงในตัวแปรสภาพแวดล้อม COURSIER_OPTS เพื่อระบุตัวเลือก JVM สำหรับ Coursier ด้วย

บิลด์แบบออฟไลน์

บางครั้งคุณอาจต้องการสร้างบิลด์แบบออฟไลน์ เช่น เมื่อเดินทางบนเครื่องบิน สำหรับกรณีการใช้งานง่ายๆ ดังกล่าว ให้ดึงข้อมูลที่เก็บที่จำเป็นล่วงหน้าด้วย bazel fetch หรือ bazel sync หากต้องการปิดใช้การดึงข้อมูลที่เก็บเพิ่มเติมระหว่างบิลด์ ให้ใช้ตัวเลือก --nofetch

สำหรับบิลด์ออฟไลน์ที่แท้จริงที่เอนทิตีอื่นจัดเตรียมไฟล์ที่จำเป็นทั้งหมด Bazel รองรับตัวเลือก --distdir แฟล็กนี้จะบอกให้ Bazel ตรวจสอบไดเรกทอรีที่ระบุโดยตัวเลือกดังกล่าวก่อน เมื่อกฎที่เก็บขอให้ Bazel ดึงข้อมูลไฟล์ด้วย ctx.download หรือ ctx.download_and_extract โดยการระบุแฮชผลรวมของไฟล์ที่ต้องการ Bazel จะค้นหาไฟล์ที่ตรงกับชื่อฐานของ URL แรก และใช้สำเนาในเครื่องหากแฮชตรงกัน

Bazel เองก็ใช้เทคนิคนี้เพื่อเปิดเครื่องแบบออฟไลน์จากอาร์ติแฟกต์การกระจาย ซึ่งทําโดยรวบรวมทรัพยากร Dependency ภายนอกทั้งหมดที่จําเป็นใน distdir_tar ภายใน

Bazel อนุญาตการดำเนินการตามคำสั่งที่กำหนดเองในกฎที่เก็บโดยไม่ทราบว่าเรียกใช้เครือข่ายหรือไม่ จึงไม่สามารถบังคับใช้บิลด์แบบออฟไลน์โดยสมบูรณ์ได้ หากต้องการทดสอบว่าบิลด์ทำงานแบบออฟไลน์ได้อย่างถูกต้องหรือไม่ ให้บล็อกเครือข่ายด้วยตนเอง (อย่างที่ Bazel ทำในการทดสอบ Bootstrap)