نام (NAME)

docker-network-connect - اتصال یک کانتینر به یک شبکه

خلاصه (SYNOPSIS)

docker network connect [OPTIONS] NETWORK CONTAINER

شرح (DESCRIPTION)

یک کانتینر را به یک شبکه متصل می‌کند. می‌توانید کانتینر را با نام یا شناسه (ID) آن متصل کنید. پس از اتصال، کانتینر می‌تواند با سایر کانتینرهای همان شبکه ارتباط برقرار کند.

$ docker network connect multi-host-network container1

همچنین می‌توانید از گزینه docker run --network=<network-name> برای راه‌اندازی کانتینر و اتصال فوری آن به یک شبکه استفاده کنید.

$ docker run -itd --network=multi-host-network --ip 172.20.88.22 --ip6 2001:db8::8822 busybox

می‌توانید کانتینرهایی را که به یک شبکه متصل هستند موقتاً متوقف (pause)، بازراه‌اندازی (restart) یا متوقف (stop) کنید. کانتینر هنگام اجرا به شبکه‌های پیکربندی‌شده خود متصل می‌شود.

در صورت مشخص شدن، با بازراه‌اندازی کانتینر متوقف‌شده، نشانی (یا نشانی‌های) IP کانتینر مجدداً اعمال می‌شود. اگر نشانی IP دیگر در دسترس نباشد، راه‌اندازی کانتینر با شکست مواجه می‌شود. یک راه برای اطمینان از در دسترس بودن نشانی IP، مشخص کردن یک --ip-range هنگام ایجاد شبکه و انتخاب نشانی (یا نشانی‌های) IP ایستا از خارج آن محدوده است. این کار تضمین می‌کند که تا زمانی که این کانتینر در شبکه نیست، نشانی IP به کانتینر دیگری اختصاص داده نشود.

$ docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 multi-host-network
$ docker network connect --ip 172.20.128.2 multi-host-network container2

برای بررسی اتصال کانتینر، از دستور docker network inspect استفاده کنید. برای جدا کردن یک کانتینر از شبکه از docker network disconnect استفاده کنید.

پس از اتصال در شبکه، کانتینرها می‌توانند صرفاً با استفاده از نام یا نشانی IP یک کانتینر دیگر با آن ارتباط برقرار کنند. برای شبکه‌های overlay یا افزونه‌های سفارشی که از اتصال چندمیزبانه پشتیبانی می‌کنند، کانتینرهایی که به یک شبکه چندمیزبانه متصل هستند اما از موتورهای متفاوتی اجرا شده‌اند نیز می‌توانند از همین طریق ارتباط برقرار کنند.

می‌توانید یک کانتینر را به یک یا چند شبکه متصل کنید. نیازی نیست شبکه‌ها از یک نوع باشند. برای مثال، می‌توانید یک کانتینر را به شبکه‌های bridge و overlay متصل کنید.

گزینه‌ها (OPTIONS)

--alias=[] افزودن نام مستعار در حوزه شبکه برای کانتینر

--driver-opt=[] گزینه‌های درایور برای شبکه

--gw-priority=0 بالاترین gw-priority دروازه پیش‌فرض (default gateway) را تعیین می‌کند. مقادیر مثبت و منفی را می‌پذیرد.

--ip= نشانی IPv4 (به‌عنوان مثال، "172.30.100.104")

--ip6= نشانی IPv6 (به‌عنوان مثال، "2001:db8::33")

--link= افزودن پیوند به کانتینری دیگر

--link-local-ip=[] افزودن نشانی link-local برای کانتینر

ببینید (SEE ALSO)

docker-network(1)