docker-build: en línea en la nube

PROGRAMA:

NOMBRE

docker-build: crea una nueva imagen a partir del código fuente en PATH

SINOPSIS

estibador build [--build-arg[=[]]] [--cpu-share[=0]] [--cgroup-padre[=CGROUP-PADRE]]
[--ayuda] [-f|--expediente[=RUTA / Dockerfile]] [--fuerza-rm] [--aislamiento[=tu préstamo estudiantil]] [--sin caché]
[--jalar] [-q|--tranquilo] [--rm[=verdadero]] [-t|--etiqueta[=[]]] [-m|--memoria[=MEMORIA]]
[- intercambio de memoria[=LIMITE LAS]] [--shm-tamaño[=TAMAÑO SHM]] [--período de la cpu[=0]] [--cuota de CPU[=0]]
[--cpuset-cpus[=CPUSET-CPU]] [--cpuset-mems[=CPUSET-MEMS]] [--ulimitar[=[]]] RUTA | URL | -

DESCRIPCIÓN

Esto leerá el Dockerfile del directorio especificado en TRAYECTORIA. También envía cualquier
otros archivos y directorios que se encuentran en el directorio actual al demonio de Docker. los
el contenido de este directorio sería utilizado por ADD comandos que se encuentran dentro del Dockerfile.

Advertencia, esto enviará una gran cantidad de datos al demonio de Docker dependiendo del contenido de
el directorio actual. La compilación la ejecuta el demonio de Docker, no la CLI, por lo que
el contexto debe transferirse al demonio. La CLI de Docker informa "Enviando contexto de compilación
al demonio de Docker "cuando el contexto se envía al demonio.

Cuando se proporciona la URL de un archivo tarball o de un solo Dockerfile, no se envía contexto
del cliente al demonio de Docker. En este caso, el Dockerfile en la raíz del
archive y el resto del archivo se utilizará como contexto de la compilación. Cuando un Git
repositorio se establece como el Enlance, el repositorio se clona localmente y luego se envía como
contexto.

CAMPUS

-f, --expediente=RUTA / Dockerfile
Ruta al Dockerfile para usar. Si la ruta es una ruta relativa y estás
construyendo desde un directorio local, entonces la ruta debe ser relativa a esa
directorio. Si está construyendo desde una URL remota que apunta a una
tarball o un repositorio de Git, entonces la ruta debe ser relativa a la raíz de
el contexto remoto. En todos los casos, el archivo debe estar dentro del contexto de compilación.
El valor predeterminado es Dockerfile.

--build-arg=variable
nombre y valor de un construir.

Por ejemplo, si desea pasar un valor para http_proxy, Utilizar
--build-arg = http_proxy = "http://some.proxy.url"

Los usuarios pasan estos valores en el momento de la compilación. Docker usa el construccion como el
contexto de entorno para los comandos que se ejecutan a través de Dockerfile CORRE instrucción
o para expansión variable en otras instrucciones de Dockerfile. Esto no significa
para pasar valores secretos. ⟨/ Referencia / constructor / # arg⟩

--fuerza-rm=verdadero|false
Siempre elimine los contenedores intermedios, incluso después de compilaciones fallidas. El valor predeterminado es
false.

--aislamiento="tu préstamo estudiantil"
Aislamiento especifica el tipo de tecnología de aislamiento que utilizan los contenedores.

--sin caché=verdadero|false
No utilice la caché al crear la imagen. El valor predeterminado es false.

--ayuda
Declaración de uso de impresión

--jalar=verdadero|false
Intente siempre extraer una versión más reciente de la imagen. El valor predeterminado es false.

-q, --tranquilo=verdadero|false
Suprime la salida de la compilación e imprime la ID de la imagen si se realiza correctamente. El valor predeterminado es false.

--rm=verdadero|false
Retire los contenedores intermedios después de una compilación exitosa. El valor predeterminado es verdadero.

-t, --etiqueta= ""
Nombres de repositorio (y opcionalmente con etiquetas) que se aplicarán a la imagen resultante en
caso de éxito.

-m, --memoria=MEMORIA
Limite de memoria

- intercambio de memoria=LIMITE LAS
Un valor límite igual a la memoria más el intercambio. Debe usarse con el -m (--memoria) bandera. los
intercambio LIMITE LAS siempre debe ser mayor que -m (--memoria) valor.

El formato de LIMITE LAS is [ ]. La unidad puede ser b (bytes), k (kilobytes), m
(megabytes), o g (gigabytes). Si no especifica una unidad, b se utiliza. Establecer LIMIT en -1 a
habilitar intercambio ilimitado.

--shm-tamaño=TAMAÑO SHM
Tamaño de / dev / shm. El formato es . número debe ser mayor que 0.
La unidad es opcional y se puede b (bytes), k (kilobytes), m (megabytes), o g (gigabytes).
Si omite la unidad, el sistema usa bytes.
Si omite el tamaño por completo, el sistema utiliza 64m.

--cpu-share=0
Acciones de CPU (peso relativo).

De forma predeterminada, todos los contenedores obtienen la misma proporción de ciclos de CPU.
Los recursos compartidos de CPU son un 'peso relativo', en relación con la configuración predeterminada de 1024.
Este valor predeterminado se define aquí:

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

Puede cambiar esta proporción ajustando el recurso compartido de CPU del contenedor
ponderación relativa a la ponderación de todos los demás contenedores en funcionamiento.

Para modificar la proporción del valor predeterminado de 1024, utilice el --cpu-share
para establecer la ponderación en 2 o más.

Bandera de recurso compartido de CPU de contenedor
{C0} 60% de CPU --cpu-shares = 614 (614 es 60% de 1024)
{C1} 40% de CPU --cpu-shares = 410 (410 es 40% de 1024)

La proporción solo se aplica cuando se ejecutan procesos con uso intensivo de la CPU.
Cuando las tareas de un contenedor están inactivas, los otros contenedores pueden usar la
tiempo de CPU restante. La cantidad real de tiempo de CPU utilizado varía según
el número de contenedores que se ejecutan en el sistema.

Por ejemplo, considere tres contenedores, donde uno tiene --cpu-share = 1024 y
otros dos tienen --cpu-share = 512. Cuando los procesos en los tres
los contenedores intentan usar el 100% de la CPU, el primer contenedor recibiría
50% del tiempo total de la CPU. Si agrega un cuarto recipiente con --cpu-share = 1024,
el primer contenedor solo obtiene el 33% de la CPU. Los contenedores restantes
reciben el 16.5%, 16.5% y 33% de la CPU.

Compartimiento de CPU de contenedor Indicador Tiempo de 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%

En un sistema de varios núcleos, las partes del tiempo de la CPU se distribuyen a través de la CPU
núcleos. Incluso si un contenedor está limitado a menos del 100% del tiempo de CPU, puede
utilice el 100% de cada núcleo de CPU individual.

Por ejemplo, considere un sistema con más de tres núcleos. Si comienzas uno
envase {C0} --cpu-share = 512 ejecutando un proceso y otro contenedor
{C1} --cpu-share = 1024 ejecutar dos procesos, esto puede resultar en lo siguiente
división de recursos compartidos de CPU:

Reparto de CPU de CPU de contenedor PID
100 {C0} 0 100% de CPU0
101 {C1} 1 100% de CPU1
102 {C1} 2 100% de CPU2

--período de la cpu=0
Limite el período de CPU CFS (Completely Fair Scheduler).

Limite el uso de la CPU del contenedor. Esta bandera hace que el kernel restrinja el
el uso de CPU del contenedor en el período que especifique.

--cuota de CPU=0
Limite la cuota de CPU CFS (Completely Fair Scheduler).

De forma predeterminada, los contenedores se ejecutan con todos los recursos de la CPU. Esta bandera hace que el kernel
Restrinja el uso de CPU del contenedor a la cuota que especifique.

--cpuset-cpus=CPUSET-CPU
CPU en las que permitir la ejecución (0-3, 0,1).

--cpuset-mems=CPUSET-MEMS
Nodos de memoria (MEM) en los que permitir la ejecución (0-3, 0,1). Solo efectivo en
Sistemas NUMA.

Por ejemplo, si tiene cuatro nodos de memoria en su sistema (0-3), use --cpuset-mems = 0,1 a
asegúrese de que los procesos en su contenedor Docker solo usen la memoria de las dos primeras memorias
nodos

--cgroup-padre=CGROUP-PADRE
Camino a cgrupos bajo el cual el contenedor cgrupo son creados.

Si la ruta no es absoluta, la ruta se considera relativa a la cgrupos camino de la
proceso de inicio. Los grupos C se crean si aún no existen.

--ulimitar= []
Opciones de Ulimit

Para obtener más información acerca de ulimit ver
⟨Https: //docs.docker.com/reference/commandline/run/#setting-ulimits-in-a-container⟩

EJEMPLOS

Construir la an imagen usando a Dockerfile situados dentro las corriente directorio

Las imágenes de Docker se pueden construir usando el comando build y un Dockerfile:

compilación de Docker.

Durante el proceso de compilación, Docker crea imágenes intermedias. Para conservarlos,
debe establecer explícitamente --rm = falso.

docker build --rm = false.

Una buena práctica es crear un subdirectorio con un nombre relacionado y crear el Dockerfile
en ese directorio. Por ejemplo, un directorio llamado mongo puede contener un Dockerfile para
crea una imagen de Docker MongoDB. Asimismo, se puede utilizar otro directorio llamado httpd para
almacenar Dockerfiles para las imágenes del servidor web Apache.

También es una buena práctica agregar los archivos necesarios para la imagen al subdirectorio.
A continuación, estos archivos se especificarán con el COPIA or ADD instrucciones en el Dockerfile.

Nota: Si incluye un archivo tar (una buena práctica), Docker extraerá automáticamente
el contenido del archivo tar especificado en el ADD instrucción en el especificado
objetivo.

Construir la an imagen y nombrando esa imagen

Una buena práctica es darle un nombre a la imagen que estás construyendo. Tenga en cuenta que solo a-z0-9-_.
debe utilizarse para mantener la coherencia. No hay reglas estrictas aquí, pero es mejor dar la
Consideración de nombres.

El -t/--etiqueta La bandera se usa para cambiar el nombre de una imagen. Aquí hay unos ejemplos:

Aunque no es una buena práctica, los nombres de las imágenes pueden ser arbitrarios:

docker build -t myimage.

Un mejor enfoque es proporcionar un repositorio, un nombre y una etiqueta completamente calificados y significativos
(donde la etiqueta en este contexto significa el calificador después de ":"). En este ejemplo
construya una imagen de JBoss para el repositorio de Fedora y dele la versión 1.0:

docker build -t fedora / jboss: 1.0.

El siguiente ejemplo es para el repositorio de usuarios "whenry" y usa Fedora y JBoss y proporciona
es la versión 2.1:

docker build -t whenry / fedora-jboss: v2.1.

Si no proporciona una etiqueta de versión, Docker asignará más reciente:

docker build -t whenry / fedora-jboss.

Cuando enumere las imágenes, la imagen de arriba tendrá la etiqueta más reciente.

Puede aplicar varias etiquetas a una imagen. Por ejemplo, puede aplicar el más reciente etiqueta a un
imagen recién construida y agregue otra etiqueta que haga referencia a una versión específica. Por ejemplo, para
etiquetar una imagen como whenry / fedora-jboss: último y whenry / fedora-jboss: v2.1, utilizar el
siguientes:

docker build -t whenry / fedora-jboss: último -t whenry / fedora-jboss: v2.1.

Por lo tanto, cambiar el nombre de una imagen es arbitrario, pero se debe considerar una convención útil
que tiene sentido para los consumidores y también debe tener en cuenta la comunidad de Docker
convenciones

Construir la an imagen usando a Enlance

Esto clonará el repositorio de GitHub especificado de la URL y lo usará como contexto. los
Dockerfile en la raíz del repositorio se usa como Dockerfile. Esto solo funciona si el
El repositorio de GitHub es un repositorio dedicado.

ventana acoplable construir github.com/scollier/purpletest

Nota: Puede configurar un repositorio Git arbitrario a través de la ir:// esquema.

Construir la an imagen usando a Enlance a a alquitrán contexto

Esto enviará la propia URL al demonio de Docker. El demonio buscará el tarball
archivarlo, descomprimirlo y utilizar su contenido como contexto de compilación. El Dockerfile en el
raíz del archivo y el resto del archivo se utilizará como contexto de la compilación.
Si pasa un -f RUTA / Dockerfile también, el sistema buscará ese archivo
dentro del contenido del tarball.

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

Nota: los formatos de compresión admitidos son 'xz', 'bzip2', 'gzip' e 'identity' (no
compresión).

Especificar solo la tecnología para envase (--aislamiento)

Esta opción es útil en situaciones en las que ejecuta contenedores Docker en Windows.
El --isolation = La opción establece la tecnología de aislamiento de un contenedor. En Linux, el único
apoyado es el tu préstamo estudiantil opción que utiliza espacios de nombres de Linux. En Microsoft Windows, puede
especificar estos valores:

· tu préstamo estudiantil: Use el valor especificado por el demonio de Docker --exec-optar . Si el demonio sí
no especifica una tecnología de aislamiento, Microsoft Windows usa por defecto
.

· : Solo aislamiento de espacio de nombres.

· hiperv: Aislamiento basado en particiones del hipervisor de Hyper-V.

Especificando el --aislamiento bandera sin un valor es lo mismo que configurar
--isolation = "predeterminado".

HISTORIA

Marzo de 2014, compilado originalmente por William Henry (whenry en redhat dot com) basado en
material de origen y trabajo interno de docker.com. Junio ​​de 2014, actualizado por Sven Dowideit
⟨[email protected]⟩ Junio ​​de 2015, actualizado por Sally O'Malley ⟨[email protected]⟩

Use docker-build en línea usando los servicios de onworks.net