オープンCAE勉強会@富山 第80回 講習会: Dockerメモ
Docker メモ
オープンCAE勉強会@富山・富山県立大学 中川慎二
OpenFOAM の Docker
installOpenFOAM
Docker ハブから openfoamplus/of_v1912_centos73 というイメージを取得する。すでにシステムに存在するときは,そのまま。
of_v1912 という名前のコンテナを作成して,OpenFOAM v1912を有効にしてシェルを読み込ませる。そのコンテナは起動したまま,ターミナルから切り離される。
username="$USER"
user="$(id -u)"
home="${1:-$HOME}"
imageName="openfoamplus/of_v1912_centos73"
containerName="of_v1912"
displayVar="$DISPLAY"
# List container name :
echo "*******************************************************"
echo "Following Docker containers are present on your system:"
echo "*******************************************************"
docker ps -a
# Create docker container for OpenFOAM operation
echo "*******************************************************"
echo ""
echo "Creating Docker OpenFOAM container ${containerName}"
docker run -it -d --name ${containerName} --user=${user} \
-e USER=${username} \
-e QT_X11_NO_MITSHM=1 \
-e DISPLAY=${displayVar} \
-e QT_XKB_CONFIG_ROOT=/usr/share/X11/xkb \
--workdir="${home}" \
--volume="${home}:${home}" \
--volume="/etc/group:/etc/group:ro" \
--volume="/etc/passwd:/etc/passwd:ro" \
--volume="/etc/shadow:/etc/shadow:ro" \
--volume="/etc/sudoers.d:/etc/sudoers.d:ro" \
-v=/tmp/.X11-unix:/tmp/.X11-unix ${imageName} \
/bin/bash --rcfile /opt/OpenFOAM/setImage_v1912.sh
echo "Container ${containerName} was created."
echo "*******************************************************"
echo "Run the ./startOpenFOAM script to launch container"
echo "*******************************************************"
startOpenFOAM
xサーバーへのアクセスを許可して,of_v1912 コンテナを起動する。そのコンテナを端末に割り当てたままとして,OpenFOAM v1912用環境設定を読み込む。
xhost +local:of_v1912
docker start of_v1912
docker exec -it of_v1912 /bin/bash -rcfile /opt/OpenFOAM/setImage_v1912.sh
主なコマンド
command | 内容 | 備考 |
---|---|---|
info | system-wide informationを表示する | |
ps | コンテナのリストを表示 | 停止中も表示するときは -a オプション付与 |
start | 停止しているコンテナを起動 | |
exec | Run a command in a running container | |
run | 新しいコンテナでコマンドを実行する |
memo
/bin/bash --rcfile /opt/OpenFOAM/setImage_v1912.sh
シェル起動時に,~/.bashrcの代わりに,指定したファイルを実行する。
公式ドキュメントより
https://docs.docker.com/engine/reference/commandline/docker/
$ docker
Usage: docker [OPTIONS] COMMAND [ARG...]
docker [ --help | -v | --version ]
A self-sufficient runtime for containers.
Options:
--config string Location of client config files (default "/root/.docker")
-c, --context string Name of the context to use to connect to the daemon (overrides DOCKER_HOST env var and default context set with "docker context use")
-D, --debug Enable debug mode
--help Print usage
-H, --host value Daemon socket(s) to connect to (default [])
-l, --log-level string Set the logging level ("debug"|"info"|"warn"|"error"|"fatal") (default "info")
--tls Use TLS; implied by --tlsverify
--tlscacert string Trust certs signed only by this CA (default "/root/.docker/ca.pem")
--tlscert string Path to TLS certificate file (default "/root/.docker/cert.pem")
--tlskey string Path to TLS key file (default "/root/.docker/key.pem")
--tlsverify Use TLS and verify the remote
-v, --version Print version information and quit
Commands:
attach Attach to a running container
# […]
$ docker exec --help
Usage: docker exec [OPTIONS] CONTAINER COMMAND [ARG...]
Run a command in a running container
Options:
-d, --detach Detached mode: run command in the background
--detach-keys string Override the key sequence for detaching a container
-e, --env list Set environment variables (default )
-i, --interactive Keep STDIN open even if not attached
--privileged Give extended privileges to the command
-t, --tty Allocate a pseudo-TTY
-u, --user string Username or UID (format: <name|uid>[:<group|gid>])
-w, --workdir string Working directory inside the container
$ docker run --help
Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
Run a command in a new container
Options:
--add-host list Add a custom host-to-IP mapping (host:ip)
-a, --attach list Attach to STDIN, STDOUT or STDERR
--blkio-weight uint16 Block IO (relative weight), between 10 and 1000, or 0 to disable (default 0)
--blkio-weight-device list Block IO weight (relative device weight) (default [])
--cap-add list Add Linux capabilities
--cap-drop list Drop Linux capabilities
--cgroup-parent string Optional parent cgroup for the container
--cidfile string Write the container ID to the file
--cpu-period int Limit CPU CFS (Completely Fair Scheduler) period
--cpu-quota int Limit CPU CFS (Completely Fair Scheduler) quota
--cpu-rt-period int Limit CPU real-time period in microseconds
--cpu-rt-runtime int Limit CPU real-time runtime in microseconds
-c, --cpu-shares int CPU shares (relative weight)
--cpus decimal Number of CPUs
--cpuset-cpus string CPUs in which to allow execution (0-3, 0,1)
--cpuset-mems string MEMs in which to allow execution (0-3, 0,1)
-d, --detach Run container in background and print container ID
--detach-keys string Override the key sequence for detaching a container
--device list Add a host device to the container
--device-cgroup-rule list Add a rule to the cgroup allowed devices list
--device-read-bps list Limit read rate (bytes per second) from a device (default [])
--device-read-iops list Limit read rate (IO per second) from a device (default [])
--device-write-bps list Limit write rate (bytes per second) to a device (default [])
--device-write-iops list Limit write rate (IO per second) to a device (default [])
--disable-content-trust Skip image verification (default true)
--dns list Set custom DNS servers
--dns-option list Set DNS options
--dns-search list Set custom DNS search domains
--domainname string Container NIS domain name
--entrypoint string Overwrite the default ENTRYPOINT of the image
-e, --env list Set environment variables
--env-file list Read in a file of environment variables
--expose list Expose a port or a range of ports
--gpus gpu-request GPU devices to add to the container ('all' to pass all GPUs)
--group-add list Add additional groups to join
--health-cmd string Command to run to check health
--health-interval duration Time between running the check (ms|s|m|h) (default 0s)
--health-retries int Consecutive failures needed to report unhealthy
--health-start-period duration Start period for the container to initialize before starting health-retries
countdown (ms|s|m|h) (default 0s)
--health-timeout duration Maximum time to allow one check to run (ms|s|m|h) (default 0s)
--help Print usage
-h, --hostname string Container host name
--init Run an init inside the container that forwards signals and reaps processes
-i, --interactive Keep STDIN open even if not attached
--ip string IPv4 address (e.g., 172.30.100.104)
--ip6 string IPv6 address (e.g., 2001:db8::33)
--ipc string IPC mode to use
--isolation string Container isolation technology
--kernel-memory bytes Kernel memory limit
-l, --label list Set meta data on a container
--label-file list Read in a line delimited file of labels
--link list Add link to another container
--link-local-ip list Container IPv4/IPv6 link-local addresses
--log-driver string Logging driver for the container
--log-opt list Log driver options
--mac-address string Container MAC address (e.g., 92:d0:c6:0a:29:33)
-m, --memory bytes Memory limit
--memory-reservation bytes Memory soft limit
--memory-swap bytes Swap limit equal to memory plus swap: '-1' to enable unlimited swap
--memory-swappiness int Tune container memory swappiness (0 to 100) (default -1)
--mount mount Attach a filesystem mount to the container
--name string Assign a name to the container
--network network Connect a container to a network
--network-alias list Add network-scoped alias for the container
--no-healthcheck Disable any container-specified HEALTHCHECK
--oom-kill-disable Disable OOM Killer
--oom-score-adj int Tune host's OOM preferences (-1000 to 1000)
--pid string PID namespace to use
--pids-limit int Tune container pids limit (set -1 for unlimited)
--privileged Give extended privileges to this container
-p, --publish list Publish a container's port(s) to the host
-P, --publish-all Publish all exposed ports to random ports
--read-only Mount the container's root filesystem as read only
--restart string Restart policy to apply when a container exits (default "no")
--rm Automatically remove the container when it exits
--runtime string Runtime to use for this container
--security-opt list Security Options
--shm-size bytes Size of /dev/shm
--sig-proxy Proxy received signals to the process (default true)
--stop-signal string Signal to stop a container (default "SIGTERM")
--stop-timeout int Timeout (in seconds) to stop a container
--storage-opt list Storage driver options for the container
--sysctl map Sysctl options (default map[])
--tmpfs list Mount a tmpfs directory
-t, --tty Allocate a pseudo-TTY
--ulimit ulimit Ulimit options (default [])
-u, --user string Username or UID (format: <name|uid>[:<group|gid>])
--userns string User namespace to use
--uts string UTS namespace to use
-v, --volume list Bind mount a volume
--volume-driver string Optional volume driver for the container
--volumes-from list Mount volumes from the specified container(s)
-w, --workdir string Working directory inside the container
関連ページ
事前作業用資料
オープンCAE勉強会@富山 第80回 講習会
OpenFOAMを0から始める:仮想マシンのインポート
https://nakagawa-lab.kibe.la/shared/entries/4513d835-b606-4db9-8815-b5fa5a8dda5d
OpenFOAM v7 のインストール
https://nakagawa-lab.kibe.la/shared/entries/db222dc8-a65d-4138-8702-8e5331186614
OpenFOAM v1912 のインストール
https://nakagawa-lab.kibe.la/shared/entries/b81a7cf5-53eb-456b-8d30-f3bb61013634
当日用資料
当日資料:オープンCAE勉強会@富山 第80回 講習会
https://nakagawa-lab.kibe.la/shared/entries/8ca75947-d188-478b-8074-c0ed55be361c
当日講習資料補足:オープンCAE勉強会@富山(第80回)
https://nakagawa-lab.kibe.la/shared/entries/a6fa6eae-af46-472d-a1a5-40ff2a81c207
Dockerメモ ← この資料
付録
講習用配布マシンの説明
https://nakagawa-lab.kibe.la/shared/entries/07261560-338e-4b5f-9fb9-13e446e1381f