docker-build - Bulutta Çevrimiçi

Program:

ADI

docker-build - PATH'deki kaynak kodundan yeni bir görüntü oluşturun

SİNOPSİS

liman işçisi inşa etmek [--build-arg[=[]]] [--cpu-hisseleri[=0]] [--cgroup-ebeveyn[=CGROUP-EBEVEYN]]
[--yardım et] [-f|--dosya[=YOL/Docker dosyası]] [--force-rm] [--izolasyon[=varsayılan]] [--önbellek yok]
[--çekmek] [-q|--sessizlik] [--rm[=gerçek]] [-t|--etiket[=[]]] [-m|--hafıza[=BELLEK]]
[--bellek değiş tokuşu[=LİMİT]] [--shm-boyutu[=SHM-BOYUTU]] [--cpu-dönemi[=0]] [--cpu kotası[=0]]
[--cpuset-cpus[=CPUSET-CPU]] [--cpuset-mems[=CPUSET-MEMS]] [--ulimit[=[]]] YOL | URL'si | -

TANIM

Bu, Docker dosyasını belirtilen dizinden okuyacaktır. PATH. Ayrıca herhangi bir şey gönderir
geçerli dizinde bulunan diğer dosya ve dizinleri Docker arka plan programına aktarır.
Bu dizinin içeriği şu kişiler tarafından kullanılacaktır: ADD Docker dosyasında bulunan komutlar.

Uyarı, bu, içeriğine bağlı olarak Docker arka plan programına çok fazla veri gönderecektir.
geçerli dizin. Derleme CLI tarafından değil Docker arka plan programı tarafından çalıştırılır, dolayısıyla tüm
bağlamın arka plan programına aktarılması gerekir. Docker CLI, "Derleme bağlamı gönderiliyor
Bağlam arka plan programına gönderildiğinde Docker arka plan programına".

Bir tarball arşivinin veya tek bir Docker dosyasının URL'si verildiğinde hiçbir içerik gönderilmez
istemciden Docker arka plan programına. Bu durumda kökündeki Docker dosyası
arşiv ve arşivin geri kalanı yapının bağlamı olarak kullanılacaktır. Git ne zaman
depo şu şekilde ayarlandı: URL, depo yerel olarak klonlanır ve ardından
bağlamı.

SEÇENEKLER

-f, --dosya=YOL/Docker dosyası
Kullanılacak Docker dosyasının yolu. Yol göreceli bir yolsa ve siz
yerel bir dizinden derleme yapıyorsanız, yol buna göre olmalıdır
dizin. Aşağıdakilerden birine işaret eden uzak bir URL'den oluşturuyorsanız:
tarball veya Git deposuysa yol, tarball'ın köküne göre olmalıdır.
uzak bağlam. Her durumda dosyanın derleme bağlamı içinde olması gerekir.
Varsayılan Dockerfile.

--build-arg=değişken
a'nın adı ve değeri inşaat arg.

Örneğin, bir değer iletmek istiyorsanız http_proxyKullanmak
--build-arg=http_proxy = "http://some.proxy.url"

Kullanıcılar bu değerleri derleme sırasında iletir. Docker şunu kullanır: İnşaat args gibi
Dockerfile aracılığıyla çalıştırılan komutlar için ortam bağlamı KOŞMAK talimat
veya diğer Dockerfile talimatlarındaki değişken genişletme için. Bu demek değil
gizli değerleri iletmek için. ⟨/referans/oluşturucu/#arg⟩

--force-rm=gerçek|yanlış
Başarısız kurulumlardan sonra bile ara kapları daima çıkarın. Varsayılan:
yanlış.

--izolasyon="varsayılan"
İzolasyon, kaplar tarafından kullanılan izolasyon teknolojisinin türünü belirtir.

--önbellek yok=gerçek|yanlış
Görüntüyü oluştururken önbellek kullanmayın. Varsayılan: yanlış.

--yardım et
Kullanım bildirimini yazdır

--çekmek=gerçek|yanlış
Her zaman görselin daha yeni bir versiyonunu almaya çalışın. Varsayılan: yanlış.

-q, --sessizlik=gerçek|yanlış
Başarı durumunda derleme çıktısını bastırın ve görüntü kimliğini yazdırın. Varsayılan: yanlış.

--rm=gerçek|yanlış
Başarılı bir derlemenin ardından ara kapları kaldırın. Varsayılan: gerçek.

-t, --etiket=""
Ortaya çıkan görüntüye uygulanacak depo adları (ve isteğe bağlı olarak etiketlerle birlikte)
başarı durumu.

-m, --hafıza=BELLEK
Bellek sınırı

--bellek değiş tokuşu=LİMİT
Bellek artı takasa eşit bir sınır değeri. ile kullanılmalıdır -m (--hafıza) bayrak. NS
takas LİMİT her zaman daha büyük olmalıdır -m (--hafıza) değer.

Formatı LİMİT is [ ]. Birim olabilir b (bayt), k (kilobayt), m
(megabayt) veya g (gigabayt). Bir birim belirtmezseniz, b kullanıldı. LIMIT olarak ayarla -1 için
sınırsız takası etkinleştirin.

--shm-boyutu=SHM-BOYUTU
Boyutu /dev/shm. biçim . numara daha büyük olmalıdır 0.
Birim isteğe bağlıdır ve olabilir b (bayt), k (kilobayt), m (megabayt) veya g (gigabayt).
Birimi atlarsanız, sistem bayt kullanır.
Boyutu tamamen atlarsanız, sistem şunu kullanır: 64m.

--cpu-hisseleri=0
CPU paylaşımları (göreceli ağırlık).

Varsayılan olarak tüm kapsayıcılar aynı oranda CPU döngüsü alır.
CPU paylaşımları, varsayılan ayar olan 1024'e göre 'göreceli bir ağırlıktır'.
Bu varsayılan değer burada tanımlanır:

kedi /sys/fs/cgroup/cpu/cpu.shares
1024

Kabın CPU paylaşımını ayarlayarak bu oranı değiştirebilirsiniz
diğer tüm çalışan konteynerlerin ağırlığına göre ağırlıklandırma.

Oranı varsayılan 1024'ten değiştirmek için, --cpu-hisseleri
Ağırlığı 2 veya daha yükseğe ayarlamak için bayrak.

Konteyner CPU paylaşımı Bayrağı
{C0} CPU'nun %60'ı --cpu-shares=614 (614, 60'ün %1024'ıdır)
{C1} CPU'nun %40'ı --cpu-shares=410 (410, 40'ün %1024'ıdır)

Oran yalnızca CPU'yu yoğun olarak kullanan işlemler çalışırken uygulanır.
Bir kapsayıcıdaki görevler boşta olduğunda, diğer kapsayıcılar bu görevi kullanabilir.
kalan CPU zamanı. Kullanılan gerçek CPU süresi miktarı bağlı olarak değişir.
Sistemde çalışan konteyner sayısı.

Örneğin, birinin bulunduğu üç konteyneri düşünün. --cpu-paylaşımları=1024 ve
iki kişi daha var --cpu-paylaşımları=512. Üçünde de süreçler olduğunda
kapsayıcılar CPU'nun %100'ünü kullanmaya çalışırsa, ilk kapsayıcı alır
Toplam CPU süresinin %50'si. Dördüncü bir kap eklerseniz --cpu-paylaşımları=1024,
ilk konteyner CPU'nun yalnızca %33'ünü alır. Kalan konteynerler
CPU'nun %16.5'ini, %16.5'ini ve %33'ünü alır.

Konteyner CPU paylaşımı CPU süresini işaretle
{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

Çok çekirdekli bir sistemde CPU zamanının payları CPU'ya dağıtılır
çekirdekler. Bir kapsayıcı CPU süresinin %100'ünden daha azıyla sınırlı olsa bile
her bir CPU çekirdeğinin %100'ünü kullanın.

Örneğin üçten fazla çekirdeği olan bir sistemi düşünün. Eğer birine başlarsan
konteyner {C0} ile --cpu-paylaşımları=512 bir işlemi ve başka bir kapsayıcıyı çalıştırmak
{C1} ile --cpu-paylaşımları=1024 iki işlemi çalıştırıyorsanız, bu aşağıdakilerle sonuçlanabilir
CPU paylaşımlarının bölünmesi:

PID kapsayıcı CPU CPU paylaşımı
100 {C0} 0 CPU100'ın %0'ü
101 {C1} 1 CPU100'ın %1'ü
102 {C1} 2 CPU100'ın %2'ü

--cpu-dönemi=0
CPU CFS (Tamamen Adil Zamanlayıcı) süresini sınırlayın.

Kapsayıcının CPU kullanımını sınırlayın. Bu bayrak çekirdeğin kısıtlamasına neden olur.
konteynerin CPU kullanımını belirttiğiniz döneme kadar.

--cpu kotası=0
CPU CFS (Tamamen Adil Zamanlayıcı) kotasını sınırlayın.

Varsayılan olarak kapsayıcılar tam CPU kaynağıyla çalışır. Bu bayrak çekirdeğin
kapsayıcının CPU kullanımını belirttiğiniz kotayla sınırlayın.

--cpuset-cpus=CPUSET-CPU
Yürütmeye izin verilecek CPU'lar (0-3, 0,1).

--cpuset-mems=CPUSET-MEMS
Yürütmeye izin verilecek bellek düğümleri (MEM'ler) (0-3, 0,1). Yalnızca şu tarihte etkilidir:
NUMA sistemleri.

Örneğin, sisteminizde dört bellek düğümünüz varsa (0-3), şunu kullanın: --cpuset-mems=0,1 için
Docker kapsayıcınızdaki işlemlerin yalnızca ilk iki bellekteki belleği kullandığından emin olun
düğümleri.

--cgroup-ebeveyn=CGROUP-EBEVEYN
Yol Cgroups konteynerin bulunduğu yerin altında grup yaratıldı.

Yol mutlak değilse yol, yola göreli olarak kabul edilir. Cgroups yolu
süreci başlatın. Halihazırda mevcut olmayan Cgroup'lar oluşturulur.

--ulimit= []
Sınır seçenekleri

Hakkında daha fazla bilgi için bkz ulimit görmek
⟨https://docs.docker.com/reference/commandline/run/#setting-ulimits-in-a-container⟩

ÖRNEKLER

bina an görüntü kullanma a Dockerfile bulunan içeride the akım rehber

Docker görüntüleri build komutu ve bir Docker dosyası kullanılarak oluşturulabilir:

liman işçisi yapısı.

Derleme işlemi sırasında Docker ara görüntüler oluşturur. Onları korumak için,
açıkça ayarlanması gerekir --rm=yanlış.

liman işçisi yapısı --rm=false .

İlgili adla bir alt dizin oluşturmak ve Dockerfile dosyasını oluşturmak iyi bir uygulamadır.
o dizinde. Örneğin, mongo adı verilen bir dizin, bir Docker dosyası içerebilir.
Docker MongoDB görüntüsü oluşturun. Benzer şekilde, httpd adı verilen başka bir dizin de kullanılabilir.
Apache web sunucusu görüntüleri için Dockerfiles'ı depolayın.

Görüntü için gereken dosyaları alt dizine eklemek de iyi bir uygulamadır.
Bu dosyalar daha sonra şu şekilde belirtilecektir: KOPYA or ADD içindeki talimatlar Dockerfile.

Not: Bir tar dosyası eklerseniz (iyi bir uygulamadır), Docker otomatik olarak tar dosyasını ayıklayacaktır
içinde belirtilen tar dosyasının içeriği ADD belirtilenlere ilişkin talimat
hedef.

bina an görüntü ve adlandırma o görüntü

Oluşturduğunuz görüntüye bir ad vermek iyi bir uygulamadır. Yalnızca a-z0-9-_ olduğunu unutmayın.
tutarlılık için kullanılmalıdır. Burada zor kurallar yok ama en iyisi
isimler dikkate alınır.

The -t/--etiket bayrak bir resmi yeniden adlandırmak için kullanılır. İşte bazı örnekler:

Her ne kadar iyi bir uygulama olmasa da görsel adları isteğe bağlı olabilir:

liman işçisi build -t resmim .

Daha iyi bir yaklaşım, tam nitelikli ve anlamlı bir depo, ad ve etiket sağlamaktır.
(burada bu bağlamda etiket ":" işaretinden sonraki niteleyici anlamına gelir). Bu örnekte biz
Fedora deposu için bir JBoss görüntüsü oluşturun ve ona 1.0 sürümünü verin:

docker build -t Fedora/jboss:1.0 .

Bir sonraki örnek "whenry" kullanıcı deposu içindir ve Fedora ve JBoss'u kullanır ve verir
sürüm 2.1:

docker build -twhenry/fedora-jboss:v2.1 .

Bir sürüm etiketi sağlamazsanız Docker, sürüm etiketini atayacaktır. son:

docker build -twhenry/fedora-jboss .

Görselleri listelediğinizde yukarıdaki görsel şu etikete sahip olacaktır: son.

Bir görsele birden fazla etiket uygulayabilirsiniz. Örneğin, şunları uygulayabilirsiniz: son etiketlemek
yeni oluşturulmuş görseli seçin ve belirli bir sürüme referans veren başka bir etiket ekleyin. Örneğin,
bir resmi her ikisini de etiketle Whenry/Fedora-jboss:en son ve Whenry/Fedora-jboss:v2.1, kullan
Aşağıdaki:

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

Dolayısıyla bir görseli yeniden adlandırmak keyfidir ancak yararlı bir kurala dikkat edilmelidir.
Bu tüketiciler için anlamlıdır ve aynı zamanda Docker topluluğunu da dikkate almalıdır.
sözleşmeler.

bina an görüntü kullanma a URL

Bu, belirtilen GitHub deposunu URL'den kopyalayacak ve bağlam olarak kullanacaktır.
Deponun kökündeki Dockerfile, Dockerfile olarak kullanılır. Bu yalnızca şu durumlarda çalışır:
GitHub deposu özel bir depodur.

liman işçisi github.com/scollier/purpletest'i derledi

Not: İsteğe bağlı bir Git deposunu git:// şema.

bina an görüntü kullanma a URL için a tarball'lanmış bağlam

Bu, URL'nin kendisini Docker arka plan programına gönderecektir. Daemon tarball'ı getirecek
arşivleyin, sıkıştırmasını açın ve içeriğini yapı bağlamı olarak kullanın. Docker dosyası
arşivin kökü ve arşivin geri kalanı yapının bağlamı olarak kullanılacaktır.
Eğer geçersen -f YOL/Docker dosyası seçeneği de varsa, sistem bu dosyayı arayacaktır
tarball'ın içeriğinin içinde.

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

Not: desteklenen sıkıştırma formatları 'xz', 'bzip2', 'gzip' ve 'identity'dir (hayır
sıkıştırma).

Belirtmek izolasyon teknoloji için konteyner (--izolasyon)

Bu seçenek, Windows'ta Docker kapsayıcıları çalıştırdığınız durumlarda kullanışlıdır.
The --izolasyon= seçenek, bir kapsayıcının yalıtım teknolojisini ayarlar. Linux'ta sadece
desteklenen varsayılan Linux ad alanlarını kullanan seçenek. Microsoft Windows'ta şunları yapabilirsiniz:
şu değerleri belirtin:

· varsayılan: Docker arka plan programı tarafından belirtilen değeri kullanın --exec-opt . Eğer daemon yok
bir izolasyon teknolojisi belirtmez, Microsoft Windows kullanır süreç varsayılan olarak
değeri.

· süreç: Yalnızca ad alanı yalıtımı.

· hiperv: Hyper-V hiper yönetici bölümü tabanlı yalıtım.

belirterek --izolasyon değeri olmayan bayrak, ayar ile aynıdır
--isolation="varsayılan".

TARİHİ

Mart 2014, İlk olarak William Henry (whenry at redhat dot com) tarafından derlenmiştir.
docker.com kaynak materyali ve dahili çalışma. Haziran 2014, Sven Dowideit tarafından güncellendi
⟨[e-posta korumalı]⟩ Haziran 2015, Sally O'Malley tarafından güncellendi ⟨[e-posta korumalı]⟩

Onworks.net hizmetlerini kullanarak docker-build'i çevrimiçi kullanın