Fig 应用编排

时间:2022-02-05 12:25:52

Fig是Docker的应用编排工具,主要用来跟 Docker 一起来构建基于 Docker 的复杂应用,Fig 通过一个配置文件来管理多个Docker容器,非常适合组合使用多个容器进行开发的场景。

说明:目前Fig已经升级并更名为Compose。Compose向下兼容Fig。 所以学完fig再去看compose也是可以的。

应用编排工具使得Docker应用管理更为方便快捷。 Fig网站:http://www.fig.sh/

安装Fig:

# 方法一:
curl -L https://github.com/docker/fig/releases/download/1.0.1/fig-`uname
-s`-`uname -m` > /usr/local/bin/fig; chmod +x /usr/local/bin/fig # Linux下等效于
curl -L https://github.com/docker/fig/releases/download/1.0.1/fig-Linux-x86_64 > /usr/local/bin/fig; chmod +x /usr/local/bin/fig # 方法二:
yum install python-pip python-dev
pip install -U fig

安装完成后可以查看版本:

# fig --version
fig 1.0.1

入门示例

准备工作:提前下载好镜像:

docker pull mysql
docker pull wordpress

需要新建一个空白目录,例如figtest。新建一个fig.yml

wordpress:
image: wordpress:latest
links:
- db:mysql
ports:
- "8002:80"
db:
image: mysql
environment:
- MYSQL_ROOT_PASSWORD=123456

以上命令的意思是新建db和wordpress容器。等同于:

$ docker run --name db -e MYSQL_ROOT_PASSWORD=123456 -d mysql
$ docker run --name some-wordpress --link db:mysql -p 8002:80 -d wordpress

好,我们启动应用:

# fig up
Creating figtest_db_1...
Creating figtest_wordpress_1...
Attaching to figtest_db_1, figtest_wordpress_1
wordpress_1 | Complete! WordPress has been successfully copied to /var/www/html

就成功了。浏览器访问 http://localhost:8002(或 http://host-ip:8002)即可。

默认是前台运行并打印日志到控制台。如果想后台运行,可以:

fig up -d

应用后台后,可以使用下列命令查看状态:

# fig ps
Name Command State Ports
-----------------------------------------------------------------------------------
figtest_db_1 docker-entrypoint.sh mysqld Up 3306/tcp
figtest_wordpress_1 docker-entrypoint.sh apach ... Up 0.0.0.0:8002->80/tcp # fig logs
Attaching to figtest_wordpress_1, figtest_db_1
db_1 | 2016-10-14T14:38:46.498030Z 0 [Warning] TIMESTAMP with implicit DEFAULT value is deprecated. Please use --explicit_defaults_for_timestamp server option (see documentation for more details).
db_1 | 2016-10-14T14:38:46.499974Z 0 [Note] mysqld (mysqld 5.7.15) starting as process 1 ...
db_1 | 2016-10-14T14:38:46.727191Z 0 [Note] InnoDB: PUNCH HOLE support available

停止应用:

# fig stop
Stopping figtest_wordpress_1...
Stopping figtest_db_1...

重新启动应用:

fig restart

scale

该命令可以设置一次性启动的容器数目:

fig.yml

wordpress:
image: daocloud.io/daocloud/dao-wordpress:latest
environment:
- WORDPRESS_DB_HOST=119.119.112.246
- WORDPRESS_DB_USER=root
- WORDPRESS_DB_PASSWORD=123456
ports:
- "80"

注意端口ports不要指定本机的。

然后:

fig scale wordpress=2

将启动两个容器:

Starting wordpresstest2_wordpress_1...
Starting wordpresstest2_wordpress_2... fig ps
Name Command State Ports
-------------------------------------------------------------------------------------------
wordpresstest2_wordpress_1 /opt/adapter.sh /entrypoin ... Up 0.0.0.0:32768->80/tcp
wordpresstest2_wordpress_2 /opt/adapter.sh /entrypoin ... Up 0.0.0.0:32769->80/tcp

fig.yml参考

每个fig.yml必须定义image或者build中的一个,其它的是可选的。

image

指定镜像tag或者ID。示例:

image: ubuntu
image: orchardup/postgresql
image: a4bc65fd

build

用来指定一个包含Dockerfile文件的路径。一般是当前目录.。Fig将build并生成一个随机命名的镜像。

command

用来覆盖缺省命令。示例:

command: python app.py

links

用于链接另一容器服务,如需要使用到另一容器的mysql服务。可以给出服务名和别名;也可以仅给出服务名,这样别名将和服务名相同。同docker run --link。示例:

links:
- db
- db:mysql
- redis

使用了别名将自动会在容器的/etc/hosts文件里创建相应记录:

172.17.2.186  db
172.17.2.186 mysql
172.17.2.187 redis

所以我们在容器里就可以直接使用别名作为服务的主机名。

ports

用于暴露端口。同docker run -p。示例:

ports:
- "3000"
- "8000:8000"
- "49100:22"
- "127.0.0.1:8001:8001"

expose

expose提供container之间的端口访问,不会暴露给主机使用。同docker run --expose

expose:
- "3000"
- "8000"

volumes

挂载数据卷。同docker run -v。示例:

volumes:
- /var/lib/mysql
- cache/:/tmp/cache
- ~/configs:/etc/configs/:ro

volumes_from

挂载数据卷容器,挂载是容器。同docker run --volumes-from。示例:

volumes:
volumes_from:
- service_name
- container_name

environment

添加环境变量。同docker run -e。可以是数组或者字典格式:

environment:
RACK_ENV: development
SESSION_SECRET: environment:
- RACK_ENV=development
- SESSION_SECRET

字典格式键值对以冒号隔开,冒号后必须有空格。

net

设置网络模式。同docker的--net参数。

net: "bridge"
net: "none"
net: "container:[name or id]"
net: "host"

dns

自定义dns服务器。

dns: 8.8.8.8
dns:
- 8.8.8.8
- 9.9.9.9

working_dir, entrypoint, user, hostname, domainname, mem_limit, privileged

这些命令都是单个值,含义请参考[docker run](Docker run reference - Docker

https://docs.docker.com/engine/reference/run/)。

working_dir: /code
entrypoint: /code/entrypoint.sh
user: postgresql hostname: foo
domainname: foo.com mem_limit: 1000000000
privileged: true

关于mem_limit实际测试发现无效果,升级到docker-compose才可以。

命令行参考

$ fig
Fast, isolated development environments using Docker. Usage:
fig [options] [COMMAND] [ARGS...]
fig -h|--help Options:
--verbose Show more output
--version Print version and exit
-f, --file FILE Specify an alternate fig file (default: fig.yml)
-p, --project-name NAME Specify an alternate project name (default: directory name) Commands:
build Build or rebuild services
help Get help on a command
kill Kill containers
logs View output from containers
port Print the public port for a port binding
ps List containers
pull Pulls service images
rm Remove stopped containers
run Run a one-off command
scale Set number of containers for a service
start Start services
stop Stop services
restart Restart services
up Create and start containers

批处理脚本

# 关闭所有正在运行容器
docker ps | awk '{print $1}' | xargs docker stop # 删除所有容器应用
docker ps -a | awk '{print $1}' | xargs docker rm
# 或者
docker rm $(docker ps -a -q)

参考:

1、Fig | Fast, isolated development environments using Docker

http://www.fig.sh

2、library/mysql - Docker Hub

https://hub.docker.com//mysql/

3、library/wordpress - Docker Hub

https://hub.docker.com/
/wordpress/