docker-build - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

docker-build - Xây dựng hình ảnh mới từ mã nguồn tại PATH

SYNOPSIS

docker xây dựng [--build-arg[=[]]] [--cpu-chia sẻ[=0]] [--cgroup-mẹ[=CGROUP-PARENT]]
[--Cứu giúp] [-f|--tập tin[=ĐƯỜNG DẪN/Tệp Docker]] [--force-rm] [--sự cách ly[=mặc định]] [- không có bộ nhớ cache]
[--sự lôi kéo] [-q|--Yên lặng] [--rm[=đúng]] [-t|--nhãn[=[]]] [-m|--kỉ niệm[=NHỚ]]
[--hoán đổi bộ nhớ[=LIMIT]] [- kích thước nhỏ gọn[=KÍCH THƯỚC SHM]] [--cpu-kỳ[=0]] [--cpu-hạn ngạch[=0]]
[--cpuset-cpus[=CPUSET-CPU]] [--cpuset-mems[=CPUSET-MEMS]] [--ulimit[=[]]] ĐƯỜNG | URL | -

MÔ TẢ

Điều này sẽ đọc Dockerfile từ thư mục được chỉ định trong PATH. Nó cũng gửi bất kỳ
các tệp và thư mục khác được tìm thấy trong thư mục hiện tại vào daemon Docker. Các
nội dung của thư mục này sẽ được sử dụng bởi THANH các lệnh được tìm thấy trong Dockerfile.

Cảnh báo, điều này sẽ gửi nhiều dữ liệu tới daemon Docker tùy thuộc vào nội dung của
thư mục hiện tại. Bản dựng được điều hành bởi trình nền Docker chứ không phải bởi CLI, vì vậy toàn bộ
context phải được chuyển tới daemon. Docker CLI báo cáo "Gửi bối cảnh xây dựng
tới Docker daemon" khi ngữ cảnh được gửi tới daemon.

Khi URL tới kho lưu trữ tarball hoặc tới một Dockerfile duy nhất được cung cấp, không có ngữ cảnh nào được gửi
từ máy khách đến daemon Docker. Trong trường hợp này, Dockerfile ở thư mục gốc của
archive và phần còn lại của kho lưu trữ sẽ được sử dụng làm bối cảnh của bản dựng. Khi một Git
kho lưu trữ được đặt là URL, kho lưu trữ được sao chép cục bộ và sau đó được gửi dưới dạng
bối cảnh.

LỰA CHỌN

-f, --tập tin=ĐƯỜNG DẪN/Tệp Docker
Đường dẫn đến Dockerfile để sử dụng. Nếu đường dẫn là một đường dẫn tương đối và bạn
xây dựng từ một thư mục cục bộ thì đường dẫn phải liên quan đến thư mục đó
danh mục. Nếu bạn đang xây dựng từ một URL từ xa trỏ đến một
tarball hoặc kho lưu trữ Git, thì đường dẫn phải liên quan đến thư mục gốc của
bối cảnh từ xa. Trong mọi trường hợp, tệp phải nằm trong ngữ cảnh xây dựng.
Mặc định là Dockerfile.

--build-arg=biến
tên và giá trị của một xây dựng.

Ví dụ: nếu bạn muốn chuyển một giá trị cho http Proxy, Sử dụng
--build-arg=http_proxy="http://some.proxy.url"

Người dùng chuyển các giá trị này vào thời gian xây dựng. Docker sử dụng xây dựng như
bối cảnh môi trường cho (các) lệnh chạy qua Dockerfile CHẠY hướng dẫn
hoặc để mở rộng biến trong các hướng dẫn Dockerfile khác. Điều này không có nghĩa là
để truyền các giá trị bí mật. ⟨/tham khảo/người xây dựng/#arg⟩

--force-rm=đúng|sai
Luôn xóa các vùng chứa trung gian, ngay cả sau khi xây dựng không thành công. Mặc định là
sai.

--sự cách ly="mặc định"
Cách ly chỉ định loại công nghệ cách ly được sử dụng bởi các thùng chứa.

- không có bộ nhớ cache=đúng|sai
Không sử dụng bộ đệm khi xây dựng hình ảnh. Mặc định là sai.

--Cứu giúp
In báo cáo sử dụng

--sự lôi kéo=đúng|sai
Luôn cố gắng lấy phiên bản mới hơn của hình ảnh. Mặc định là sai.

-q, --Yên lặng=đúng|sai
Loại bỏ đầu ra bản dựng và in ID hình ảnh khi thành công. Mặc định là sai.

--rm=đúng|sai
Loại bỏ các vùng chứa trung gian sau khi xây dựng thành công. Mặc định là đúng.

-t, --nhãn= ""
Tên kho lưu trữ (và tùy chọn có thẻ) sẽ được áp dụng cho hình ảnh thu được trong
trường hợp thành công.

-m, --kỉ niệm=NHỚ
Giới hạn bộ nhớ

--hoán đổi bộ nhớ=LIMIT
Giá trị giới hạn bằng bộ nhớ cộng với hoán đổi. Phải được sử dụng với -m (--kỉ niệm) lá cờ. Các
trao đổi LIMIT phải luôn lớn hơn -m (--kỉ niệm) giá trị.

Định dạng của LIMIT is [ ]. Đơn vị có thể là b (byte), k (kilobyte), m
(megabyte), hoặc g (gigabyte). Nếu bạn không chỉ định một đơn vị, b Được sử dụng. Đặt LIMIT thành -1 đến
cho phép hoán đổi không giới hạn.

- kích thước nhỏ gọn=KÍCH THƯỚC SHM
Kích thước của / dev / shm. Định dạng là . con số phải lớn hơn 0.
Đơn vị là tùy chọn và có thể b (byte), k (kilobyte), m (megabyte), hoặc g (gigabyte).
Nếu bạn bỏ qua đơn vị, hệ thống sẽ sử dụng byte.
Nếu bạn bỏ qua hoàn toàn kích thước, hệ thống sẽ sử dụng 64m.

--cpu-chia sẻ=0
Chia sẻ CPU (trọng lượng tương đối).

Theo mặc định, tất cả các vùng chứa đều có cùng tỷ lệ chu kỳ CPU.
Tỷ lệ chia sẻ CPU là 'trọng số tương đối', so với cài đặt mặc định là 1024.
Giá trị mặc định này được xác định ở đây:

làm sao /sys/fs/cgroup/cpu/cpu.shares
1024

Bạn có thể thay đổi tỷ lệ này bằng cách điều chỉnh phần CPU của vùng chứa
trọng lượng so với trọng lượng của tất cả các container đang chạy khác.

Để sửa đổi tỷ lệ từ mặc định là 1024, hãy sử dụng --cpu-chia sẻ
cờ để đặt trọng số thành 2 hoặc cao hơn.

Cờ chia sẻ CPU vùng chứa
{C0} 60% CPU --cpu-shares=614 (614 là 60% của 1024)
{C1} 40% CPU --cpu-shares=410 (410 là 40% của 1024)

Tỷ lệ này chỉ được áp dụng khi các tiến trình sử dụng nhiều CPU đang chạy.
Khi các tác vụ trong một vùng chứa không hoạt động, các vùng chứa khác có thể sử dụng
thời gian CPU còn sót lại. Lượng thời gian CPU thực tế được sử dụng thay đổi tùy thuộc vào
số lượng container đang chạy trên hệ thống.

Ví dụ, hãy xem xét ba container, trong đó một container có --cpu-shares=1024 và
hai người khác có --cpu-shares=512. Khi xử lý ở cả ba
vùng chứa cố gắng sử dụng 100% CPU, vùng chứa đầu tiên sẽ nhận được
50% tổng thời gian của CPU. Nếu bạn thêm vùng chứa thứ tư với --cpu-shares=1024,
vùng chứa đầu tiên chỉ nhận được 33% CPU. Các container còn lại
nhận 16.5%, 16.5% và 33% CPU.

Chia sẻ CPU vùng chứa Gắn cờ thời gian CPU
{C0} 100% --cpu-shares=1024 33%
{C1} 50% --cpu-shares=512 16.5%
{C2} 50% --cpu-shares=512 16.5%
{C4} 100% --cpu-shares=1024 33%

Trên hệ thống đa lõi, phần thời gian CPU được chia sẻ trên CPU
lõi. Ngay cả khi một container bị giới hạn dưới 100% thời gian CPU, nó vẫn có thể
sử dụng 100% từng lõi CPU riêng lẻ.

Ví dụ, hãy xem xét một hệ thống có nhiều hơn ba lõi. Nếu bạn bắt đầu một
chứa {C0} với --cpu-shares=512 đang chạy một quy trình và một vùng chứa khác
{C1} với --cpu-shares=1024 chạy hai tiến trình, điều này có thể dẫn đến kết quả sau
phân chia cổ phần CPU:

Bộ chứa PID CPU chia sẻ CPU
100 {C0} 0 100% CPU0
101 {C1} 1 100% CPU1
102 {C1} 2 100% CPU2

--cpu-kỳ=0
Giới hạn khoảng thời gian CPU CFS (Bộ lập lịch hoàn toàn công bằng).

Giới hạn mức sử dụng CPU của vùng chứa. Cờ này làm cho kernel hạn chế
mức sử dụng CPU của vùng chứa trong khoảng thời gian bạn chỉ định.

--cpu-hạn ngạch=0
Giới hạn hạn ngạch CPU CFS (Bộ lập lịch hoàn toàn công bằng).

Theo mặc định, các container chạy với toàn bộ tài nguyên CPU. Cờ này làm cho kernel
hạn chế mức sử dụng CPU của vùng chứa ở hạn mức bạn chỉ định.

--cpuset-cpus=CPUSET-CPU
CPU cho phép thực thi (0-3, 0,1).

--cpuset-mems=CPUSET-MEMS
Các nút bộ nhớ (MEM) trong đó cho phép thực thi (0-3, 0,1). Chỉ có hiệu lực trên
hệ thống NUMA.

Ví dụ: nếu bạn có bốn nút bộ nhớ trên hệ thống của mình (0-3), hãy sử dụng --cpuset-mems = 0,1 đến
đảm bảo các tiến trình trong vùng chứa Docker của bạn chỉ sử dụng bộ nhớ từ hai bộ nhớ đầu tiên
điểm giao.

--cgroup-mẹ=CGROUP-PARENT
Đường dẫn đến nhóm trong đó container nhóm được tạo ra.

Nếu đường dẫn không tuyệt đối thì đường dẫn được coi là tương đối với nhóm con đường của
quá trình khởi tạo. Các nhóm được tạo nếu chúng chưa tồn tại.

--ulimit= []
Bỏ qua các tùy chọn

Để biết thêm thông tin về giới hạn xem
⟨https://docs.docker.com/reference/commandline/run/#setting-ulimits-in-a-container⟩

VÍ DỤ

Xây dựng an hình ảnh sử dụng a Dockerfile nằm trong các hiện hành thư mục

Hình ảnh Docker có thể được xây dựng bằng lệnh build và Dockerfile:

xây dựng docker.

Trong quá trình xây dựng Docker tạo các image trung gian. Để giữ chúng, bạn
phải đặt rõ ràng --rm=sai.

xây dựng docker --rm=false .

Một cách tốt là tạo một thư mục con có tên liên quan và tạo Dockerfile
trong thư mục đó. Ví dụ: thư mục có tên mongo có thể chứa Dockerfile để
tạo hình ảnh Docker MongoDB. Tương tự như vậy, một thư mục khác có tên httpd có thể được sử dụng để
lưu trữ Dockerfiles cho hình ảnh máy chủ web Apache.

Bạn cũng nên thêm các tệp cần thiết cho hình ảnh vào thư mục con.
Những tập tin này sau đó sẽ được chỉ định với COPY or THANH hướng dẫn trong Dockerfile.

Lưu ý: Nếu bạn bao gồm tệp tar (một cách tốt), thì Docker sẽ tự động giải nén
nội dung của tệp tar được chỉ định trong THANH hướng dẫn theo quy định
Mục tiêu.

Xây dựng an hình ảnh và đặt tên việc này hình ảnh

Một cách thực hành tốt là đặt tên cho hình ảnh bạn đang xây dựng. Lưu ý chỉ có a-z0-9-_.
nên được sử dụng để đảm bảo tính nhất quán. Không có quy tắc cứng nhắc nào ở đây nhưng tốt nhất là bạn nên đưa ra
xem xét tên.

Sản phẩm -t/--nhãn cờ được sử dụng để đổi tên một hình ảnh. Dưới đây là một số ví dụ:

Mặc dù đây không phải là cách làm tốt nhưng tên hình ảnh có thể tùy ý:

docker build -t myimage .

Cách tiếp cận tốt hơn là cung cấp kho lưu trữ, tên và thẻ đủ điều kiện và có ý nghĩa
(trong đó thẻ trong ngữ cảnh này có nghĩa là từ hạn định sau dấu ":"). Trong ví dụ này chúng ta
xây dựng hình ảnh JBoss cho kho Fedora và cung cấp cho nó phiên bản 1.0:

docker build -t fedora/jboss:1.0 .

Ví dụ tiếp theo dành cho kho lưu trữ người dùng "whenry" và sử dụng Fedora và JBoss và cung cấp
đó là phiên bản 2.1:

docker build -t Whenry/Fedora-jboss:v2.1 .

Nếu bạn không cung cấp thẻ phiên bản thì Docker sẽ chỉ định mới nhất:

docker build -t Whenry/Fedora-jboss .

Khi liệt kê các hình ảnh thì hình ảnh trên sẽ có tag mới nhất.

Bạn có thể áp dụng nhiều thẻ cho một hình ảnh. Ví dụ: bạn có thể áp dụng mới nhất gắn thẻ vào một
hình ảnh mới được tạo và thêm một thẻ khác tham chiếu đến một phiên bản cụ thể. Ví dụ, để
gắn thẻ một hình ảnh như Whenry/Fedora-jboss:mới nhất và Whenry/Fedora-jboss:v2.1, sử dụng
Sau đây:

docker build -t Whenry/Fedora-jboss:latest -t Whenry/Fedora-jboss:v2.1 .

Vì vậy, việc đổi tên hình ảnh là tùy ý nhưng cần cân nhắc quy ước hữu ích
điều đó có ý nghĩa đối với người tiêu dùng và cũng nên tính đến cộng đồng Docker
các quy ước.

Xây dựng an hình ảnh sử dụng a URL

Điều này sẽ sao chép kho lưu trữ GitHub được chỉ định từ URL và sử dụng nó làm ngữ cảnh. Các
Dockerfile ở thư mục gốc của kho lưu trữ được sử dụng làm Dockerfile. Điều này chỉ hoạt động nếu
Kho lưu trữ GitHub là một kho lưu trữ chuyên dụng.

docker build github.com/scollier/purpletest

Lưu ý: Bạn có thể đặt kho lưu trữ Git tùy ý thông qua git:// lược đồ.

Xây dựng an hình ảnh sử dụng a URL đến a tarball bối cảnh

Điều này sẽ tự gửi URL tới trình nền Docker. Daemon sẽ lấy tarball
lưu trữ, giải nén nó và sử dụng nội dung của nó làm bối cảnh xây dựng. Dockerfile tại
gốc của kho lưu trữ và phần còn lại của kho lưu trữ sẽ được sử dụng làm bối cảnh của bản dựng.
Nếu bạn vượt qua một -f ĐƯỜNG DẪN/Tệp Docker tùy chọn, hệ thống sẽ tìm tập tin đó
bên trong nội dung của tarball.

docker build -f dev/Dockerfile https://10.10.10.1/docker/context.tar.gz

Lưu ý: các định dạng nén được hỗ trợ là 'xz', 'bzip2', 'gzip' và 'identity' (không có
nén).

Chỉ định cô lập công nghệ cho chứa (--sự cách ly)

Tùy chọn này hữu ích trong các trường hợp bạn đang chạy vùng chứa Docker trên Windows.
Sản phẩm --isolation = tùy chọn đặt công nghệ cách ly của vùng chứa. Trên Linux,
được hỗ trợ là mặc định tùy chọn sử dụng không gian tên Linux. Trên Microsoft Windows, bạn có thể
chỉ định các giá trị sau:

· mặc định: Sử dụng giá trị được chỉ định bởi Docker daemon --exec-opt . Nếu daemon làm
không chỉ định một công nghệ cách ly, Microsoft Windows sử dụng quá trình như mặc định của nó
giá trị.

· quá trình: Chỉ cách ly không gian tên.

· hyperv: Cách ly dựa trên phân vùng siêu giám sát Hyper-V.

Chỉ định --sự cách ly cờ không có giá trị cũng giống như cài đặt
--isolation = "default".

LỊCH SỬ

Tháng 2014 năm XNUMX, được biên soạn lần đầu bởi William Henry (whenry at redhat dot com) dựa trên
tài liệu nguồn docker.com và công việc nội bộ. Tháng 2014 năm XNUMX, được cập nhật bởi Sven Dowideit
⟨[email được bảo vệ]⟩ Tháng 2015 năm XNUMX, được cập nhật bởi Sally O'Malley ⟨[email được bảo vệ]⟩

Sử dụng docker-build trực tuyến bằng dịch vụ onworks.net