compose文件格式版本 | docker版本 |
---|---|
3.4 | 17.09.0+ |
3.3 | 17.06.0+ |
3.2 | 17.04.0+ |
3.1 | 1.13.1+ |
3.0 | 1.13.0+ |
2.3 | 17.06.0+ |
2.2 | 1.13.0+ |
2.1 | 1.12.0+ |
2.0 | 1.10.0+ |
1.0 | 1.9.1.+ |
Docker版本變化說明:
Docker從1.13.x版本開始,版本分為企業(yè)版EE和社區(qū)版CE,版本號(hào)也改為按照時(shí)間線來發(fā)布,比如17.03就是2017年3月。
Docker的linux發(fā)行版的軟件倉(cāng)庫(kù)從以前的https://apt.dockerproject.org和https://yum.dockerproject.org變更為目前的https://download.docker.com, 軟件包名字改為docker-ce和docker-ee。
Docker的社區(qū)版(Docker Community Edition)叫做docker-ce。老版本的Docker包叫做docker或者docker-engine,如果安裝了老版本的docker得先卸載然后再安裝新版本的docker。docker的發(fā)展非常迅速,apt源的更新往往比較滯后。所以docker官網(wǎng)推薦的安裝方式都是下載docker安裝腳本安裝。
卸載老舊的版本(若未安裝過可省略此步):
$ sudo apt-get remove docker docker-engine docker.io
安裝最新的docker:
$ curl -fsSL get.docker.com -o get-docker.sh $ sudo sh get-docker.sh
shell會(huì)提示你輸入sudo的密碼,然后開始執(zhí)行最新的docker過程
或者
$ curl -sSL https://get.docker.com/ | sh
確認(rèn)Docker成功最新的docker:
$ sudo docker run hello-world
兩種最新的docker安裝方式
下載最新版的docker-compose文件
sudo curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
若是github訪問太慢,可以用daocloud下載
sudo curl -L https://get.daocloud.io/docker/compose/releases/download/1.25.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
添加可執(zhí)行權(quán)限
sudo chmod +x /usr/local/bin/docker-compose
測(cè)試安裝結(jié)果
$ docker-compose --version docker-compose version 1.16.1, build 1719ceb
sudo pip install docker-compose
docker-compose.yml:
version: "3" services: redis: image: redis:alpine ports: - "6379" networks: - frontend deploy: replicas: 2 update_config: parallelism: 2 delay: 10s restart_policy: condition: on-failure db: image: postgres:9.4 volumes: - db-data:/var/lib/postgresql/data networks: - backend deploy: placement: constraints: [node.role == manager] vote: image: dockersamples/examplevotingapp_vote:before ports: - 5000:80 networks: - frontend depends_on: - redis deploy: replicas: 2 update_config: parallelism: 2 restart_policy: condition: on-failure result: image: dockersamples/examplevotingapp_result:before ports: - 5001:80 networks: - backend depends_on: - db deploy: replicas: 1 update_config: parallelism: 2 delay: 10s restart_policy: condition: on-failure worker: image: dockersamples/examplevotingapp_worker networks: - frontend - backend deploy: mode: replicated replicas: 1 labels: [APP=VOTING] restart_policy: condition: on-failure delay: 10s max_attempts: 3 window: 120s placement: constraints: [node.role == manager] visualizer: image: dockersamples/visualizer:stable ports: - "8080:8080" stop_grace_period: 1m30s volumes: - "/var/run/docker.sock:/var/run/docker.sock" deploy: placement: constraints: [node.role == manager] networks: frontend: backend: volumes: db-data:
通過docker-compose構(gòu)建一個(gè)在docker中運(yùn)行的基于python flask框架的web應(yīng)用。
注意:確保你已經(jīng)安裝了Docker Engine和Docker Compose。 您不需要安裝Python或Redis,因?yàn)檫@兩個(gè)都是由Docker鏡像提供的。
Step 1: 定義python應(yīng)用
1 .創(chuàng)建工程目錄
$ mkdir compose_test $ cd compose_test $ mkdir src # 源碼文件夾 $ mkdir docker # docker配置文件夾
目錄結(jié)構(gòu)如下:
└── compose_test ├── docker │ └── docker-compose.yml ├── Dockerfile └── src ├── app.py └── requirements.txt
2 .在compose_test/src/目錄下創(chuàng)建python flask應(yīng)用 compose_test/src/app.py文件。
from flask import Flask from redis import Redis app = Flask(__name__) redis = Redis(host='redis', port=6379) @app.route('/') def hello(): count = redis.incr('hits') return 'Hello World! I have been seen {} times.\n'.format(count) if __name__ == "__main__": app.run(host="0.0.0.0", debug=True)
3 .創(chuàng)建python 需求文件 compose_test/src/requirements.txt
flask redis
Step 2: 創(chuàng)建容器的Dockerfile文件
一個(gè)容器一個(gè)Dockerfile文件,在compose_test/目錄中創(chuàng)建Dockerfile文件:
FROM python:3.7 COPY src/ /opt/src WORKDIR /opt/src RUN pip install -r requirements.txt CMD ["python", "app.py"]
Dockerfile文件告訴docker了如下信息:
從Python 3.6鏡像開始構(gòu)建一個(gè)容器鏡像。
復(fù)制src(即compose_test/src)目錄到容器的/opt/src目錄。
將容器的工作目錄設(shè)置為/opt/src(通過docker exec -it your_docker_container_id_or_name bash 進(jìn)入容器后的默認(rèn)目錄)。
安裝Python依賴關(guān)系。
將容器的默認(rèn)命令設(shè)置為python app.py。
Step 3: 定義docker-compose腳本
在compose_test/docker/目錄下創(chuàng)建docker-compose.yml文件,并在里面定義服務(wù),內(nèi)容如下:
version: '3' services: web: build: ../ ports: - "5000:5000" redis: image: "redis:3.0.7"
這個(gè)compose文件定義了兩個(gè)服務(wù),即定義了web和redis兩個(gè)容器。
web容器:
* 使用當(dāng)前docker-compose.yml文件所在目錄的上級(jí)目錄(compose_test/Dockerfile)中的Dockerfile構(gòu)建映像。
* 將容器上的暴露端口5000映射到主機(jī)上的端口5000。 我們使用Flask Web服務(wù)器的默認(rèn)端口5000。
redis容器:
* redis服務(wù)使用從Docker Hub提取的官方redis鏡像3.0.7版本。
Step 4: 使用Compose構(gòu)建并運(yùn)行您的應(yīng)用程序
在compose_test/docker/目錄下執(zhí)行docker-compose.yml文件:
$ docker-compose up # 若是要后臺(tái)運(yùn)行: $ docker-compose up -d # 若不使用默認(rèn)的docker-compose.yml 文件名: $ docker-compose -f server.yml up -d
然后在瀏覽器中輸入http://0.0.0.0:5000/查看運(yùn)行的應(yīng)用程序。
Step 5: 編輯compose文件以添加文件綁定掛載
上面的代碼是在構(gòu)建時(shí)靜態(tài)復(fù)制到容器中的,即通過Dockerfile文件中的COPY src /opt/src命令實(shí)現(xiàn)物理主機(jī)中的源碼復(fù)制到容器中,這樣在后續(xù)物理主機(jī)src目錄中代碼的更改不會(huì)反應(yīng)到容器中。
可以通過volumes 關(guān)鍵字實(shí)現(xiàn)物理主機(jī)目錄掛載到容器中的功能(同時(shí)刪除Dockerfile中的COPY指令,不需要?jiǎng)?chuàng)建鏡像時(shí)將代碼打包進(jìn)鏡像,而是通過volums動(dòng)態(tài)掛載,容器和物理host共享數(shù)據(jù)卷):
version: '3' services: web: build: ../ ports: - "5000:5000" volumes: - ../src:/opt/src redis: image: "redis:3.0.7"
通過volumes(卷)將主機(jī)上的項(xiàng)目目錄(compose_test/src)掛載到容器中的/opt/src目錄下,允許您即時(shí)修改代碼,而無(wú)需重新構(gòu)建映像。
Step 6: 重新構(gòu)建和運(yùn)行應(yīng)用程序
使用更新的compose文件構(gòu)建應(yīng)用程序,然后運(yùn)行它。
$ docker-compose up -d
Compose文件是一個(gè)定義服務(wù),網(wǎng)絡(luò)和卷的YAML文件。 Compose文件的默認(rèn)文件名為docker-compose.yml。
**提示:您可以對(duì)此文件使用.yml或.yaml擴(kuò)展名。 他們都工作。
與docker運(yùn)行一樣,默認(rèn)情況下,Dockerfile中指定的選項(xiàng)(例如,CMD,EXPOSE,VOLUME,ENV)都被遵守,你不需要在docker-compose.yml中再次指定它們。
同時(shí)你可以使用類似Bash的$ {VARIABLE} 語(yǔ)法在配置值中使用環(huán)境變量,有關(guān)詳細(xì)信息,請(qǐng)參閱變量替換。
本節(jié)包含版本3中服務(wù)定義支持的所有配置選項(xiàng)。
build
build 可以指定包含構(gòu)建上下文的路徑:
version: '2' services: webapp: build: ./dir
或者,作為一個(gè)對(duì)象,該對(duì)象具有上下文路徑和指定的Dockerfile文件以及args參數(shù)值:
version: '2' services: webapp: build: context: ./dir dockerfile: Dockerfile-alternate args: buildno: 1
webapp服務(wù)將會(huì)通過./dir目錄下的Dockerfile-alternate文件構(gòu)建容器鏡像。
如果你同時(shí)指定image和build,則compose會(huì)通過build指定的目錄構(gòu)建容器鏡像,而構(gòu)建的鏡像名為image中指定的鏡像名和標(biāo)簽。
build: ./dir image: webapp:tag
這將由./dir構(gòu)建的名為webapp和標(biāo)記為tag的鏡像。
context
包含Dockerfile文件的目錄路徑,或者是git倉(cāng)庫(kù)的URL。
當(dāng)提供的值是相對(duì)路徑時(shí),它被解釋為相對(duì)于當(dāng)前compose文件的位置。 該目錄也是發(fā)送到Docker守護(hù)程序構(gòu)建鏡像的上下文。
dockerfile
備用Docker文件。Compose將使用備用文件來構(gòu)建。 還必須指定構(gòu)建路徑。
args
添加構(gòu)建鏡像的參數(shù),環(huán)境變量只能在構(gòu)建過程中訪問。
首先,在Dockerfile中指定要使用的參數(shù):
ARG buildno ARG password RUN echo "Build number: $buildno" RUN script-requiring-password.sh "$password"
然后在args鍵下指定參數(shù)。 你可以傳遞映射或列表:
build: context: . args: buildno: 1 password: secret build: context: . args: - buildno=1 - password=secret
** 注意:YAML布爾值(true,false,yes,no,on,off)必須用引號(hào)括起來,以便解析器將它們解釋為字符串。
image
指定啟動(dòng)容器的鏡像,可以是鏡像倉(cāng)庫(kù)/標(biāo)簽或者鏡像id(或者id的前一部分)
image: redis image: ubuntu:14.04 image: tutum/influxdb image: example-registry.com:4000/postgresql image: a4bc65fd
如果鏡像不存在,Compose將嘗試從官方鏡像倉(cāng)庫(kù)將其pull下來,如果你還指定了build,在這種情況下,它將使用指定的build選項(xiàng)構(gòu)建它,并使用image指定的名字和標(biāo)記對(duì)其進(jìn)行標(biāo)記。
container_name
指定一個(gè)自定義容器名稱,而不是生成的默認(rèn)名稱。
container_name: my-web-container
由于Docker容器名稱必須是唯一的,因此如果指定了自定義名稱,則無(wú)法將服務(wù)擴(kuò)展到多個(gè)容器。
volumes
卷掛載路徑設(shè)置??梢栽O(shè)置宿主機(jī)路徑 (HOST:CONTAINER) 或加上訪問模式 (HOST:CONTAINER:ro),掛載數(shù)據(jù)卷的默認(rèn)權(quán)限是讀寫(rw),可以通過ro指定為只讀。
你可以在主機(jī)上掛載相對(duì)路徑,該路徑將相對(duì)于當(dāng)前正在使用的Compose配置文件的目錄進(jìn)行擴(kuò)展。 相對(duì)路徑應(yīng)始終以 . 或者 .. 開始。
volumes: # 只需指定一個(gè)路徑,讓引擎創(chuàng)建一個(gè)卷 - /var/lib/mysql # 指定絕對(duì)路徑映射 - /opt/data:/var/lib/mysql # 相對(duì)于當(dāng)前compose文件的相對(duì)路徑 - ./cache:/tmp/cache # 用戶家目錄相對(duì)路徑 - ~/configs:/etc/configs/:ro # 命名卷 - datavolume:/var/lib/mysql
但是,如果要跨多個(gè)服務(wù)并重用掛載卷,請(qǐng)?jiān)陧敿?jí)volumes關(guān)鍵字中命名掛在卷,但是并不強(qiáng)制,如下的示例亦有重用掛載卷的功能,但是不提倡。
version: "3" services: web1: build: ./web/ volumes: - ../code:/opt/web/code web2: build: ./web/ volumes: - ../code:/opt/web/code
** 注意:通過頂級(jí)volumes定義一個(gè)掛載卷,并從每個(gè)服務(wù)的卷列表中引用它, 這會(huì)替換早期版本的Compose文件格式中volumes_from。
version: "3" services: db: image: db volumes: - data-volume:/var/lib/db backup: image: backup-service volumes: - data-volume:/var/lib/backup/data volumes: data-volume:
command
覆蓋容器啟動(dòng)后默認(rèn)執(zhí)行的命令。
command: bundle exec thin -p 3000
該命令也可以是一個(gè)類似于dockerfile的列表:
command: ["bundle", "exec", "thin", "-p", "3000"]
links
鏈接到另一個(gè)服務(wù)中的容器。 請(qǐng)指定服務(wù)名稱和鏈接別名(SERVICE:ALIAS),或者僅指定服務(wù)名稱。
web: links: - db - db:database - redis
在當(dāng)前的web服務(wù)的容器中可以通過鏈接的db服務(wù)的別名database訪問db容器中的數(shù)據(jù)庫(kù)應(yīng)用,如果沒有指定別名,則可直接使用服務(wù)名訪問。
鏈接不需要啟用服務(wù)進(jìn)行通信 - 默認(rèn)情況下,任何服務(wù)都可以以該服務(wù)的名稱到達(dá)任何其他服務(wù)。 (實(shí)際是通過設(shè)置/etc/hosts的域名解析,從而實(shí)現(xiàn)容器間的通信。故可以像在應(yīng)用中使用localhost一樣使用服務(wù)的別名鏈接其他容器的服務(wù),前提是多個(gè)服務(wù)容器在一個(gè)網(wǎng)絡(luò)中可路由聯(lián)通)
links也可以起到和depends_on相似的功能,即定義服務(wù)之間的依賴關(guān)系,從而確定服務(wù)啟動(dòng)的順序。
external_links
鏈接到docker-compose.yml 外部的容器,甚至并非 Compose 管理的容器。參數(shù)格式跟 links 類似。
external_links: - redis_1 - project_db_1:mysql - project_db_1:postgresql
expose
暴露端口,但不映射到宿主機(jī),只被連接的服務(wù)訪問。
僅可以指定內(nèi)部端口為參數(shù)
expose: - "3000" - "8000"
ports
暴露端口信息。
常用的簡(jiǎn)單格式:使用宿主:容器 (HOST:CONTAINER)格式或者僅僅指定容器的端口(宿主將會(huì)隨機(jī)選擇端口)都可以。
** 注意:當(dāng)使用 HOST:CONTAINER 格式來映射端口時(shí),如果你使用的容器端口小于 60 你可能會(huì)得到錯(cuò)誤得結(jié)果,因?yàn)?YAML 將會(huì)解析 xx:yy 這種數(shù)字格式為 60 進(jìn)制。所以建議采用字符串格式。
簡(jiǎn)單的短格式:
ports: - "3000" - "3000-3005" - "8000:8000" - "9090-9091:8080-8081" - "49100:22" - "127.0.0.1:8001:8001" - "127.0.0.1:5000-5010:5000-5010" - "6060:6060/udp"
在v3.2中ports的長(zhǎng)格式的語(yǔ)法允許配置不能用短格式表示的附加字段。
長(zhǎng)格式:
ports: - target: 80 published: 8080 protocol: tcp mode: host
target:容器內(nèi)的端口
published:物理主機(jī)的端口
protocol:端口協(xié)議(tcp或udp)
mode:host 和ingress 兩總模式,host用于在每個(gè)節(jié)點(diǎn)上發(fā)布主機(jī)端口,ingress 用于被負(fù)載平衡的swarm模式端口。
restart
no是默認(rèn)的重啟策略,在任何情況下都不會(huì)重啟容器。 指定為always時(shí),容器總是重新啟動(dòng)。 如果退出代碼指示出現(xiàn)故障錯(cuò)誤,則on-failure將重新啟動(dòng)容器。
restart: "no" restart: always restart: on-failure restart: unless-stopped
environment
添加環(huán)境變量。 你可以使用數(shù)組或字典兩種形式。 任何布爾值; true,false,yes,no需要用引號(hào)括起來,以確保它們不被YML解析器轉(zhuǎn)換為True或False。
只給定名稱的變量會(huì)自動(dòng)獲取它在 Compose 主機(jī)上的值,可以用來防止泄露不必要的數(shù)據(jù)。
environment: RACK_ENV: development SHOW: 'true' SESSION_SECRET: environment: - RACK_ENV=development - SHOW=true - SESSION_SECRET
** 注意:如果你的服務(wù)指定了build選項(xiàng),那么在構(gòu)建過程中通過environment定義的環(huán)境變量將不會(huì)起作用。 將使用build的args子選項(xiàng)來定義構(gòu)建時(shí)的環(huán)境變量。
pid
將PID模式設(shè)置為主機(jī)PID模式。 這就打開了容器與主機(jī)操作系統(tǒng)之間的共享PID地址空間。 使用此標(biāo)志啟動(dòng)的容器將能夠訪問和操作裸機(jī)的命名空間中的其他容器,反之亦然。即打開該選項(xiàng)的容器可以相互通過進(jìn)程 ID 來訪問和操作。
pid: "host"
dns
配置 DNS 服務(wù)器。可以是一個(gè)值,也可以是一個(gè)列表。
dns: 8.8.8.8 dns: - 8.8.8.8 - 9.9.9.9
到此這篇關(guān)于docker-compose教程之安裝使用和快速入門 的文章就介紹到這了,更多相關(guān)docker-compose安裝使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
標(biāo)簽:開封 晉城 石嘴山 汕頭 拉薩 鄭州 三明 玉林
巨人網(wǎng)絡(luò)通訊聲明:本文標(biāo)題《docker-compose教程之安裝使用和快速入門》,本文關(guān)鍵詞 docker-compose,教程,之,安裝,;如發(fā)現(xiàn)本文內(nèi)容存在版權(quán)問題,煩請(qǐng)?zhí)峁┫嚓P(guān)信息告之我們,我們將及時(shí)溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡(luò),涉及言論、版權(quán)與本站無(wú)關(guān)。