NETWORK
도커 컨테이너 네트워크
- Docker 컨테이너끼리 통신할 때는 Docker 네트워크를 통해 수행
- Docker는 기본 네트워크 값으로 bridge, hosts, none 세 개의 네트워크를 만듦
Docker 네트워크 목록 표시
- Docker network ls [옵션]
- 주요 옵션
- -f, –filter=[] : 출력을 필터링
- --no-trunc : 상세 정보를 출력
- -q, –quiet : 네트워크 ID만 표시
네트워크 목록 표시 (예제)
$ sudo docker network ls
NETWORK ID NAME DRIVER SCOPE
914f387eab6b bridge bridge local
c8fa1e69139e host host local
478c12382ce4 none null local- 따로 추가한게 없으므로 기본 네트워크 세 개가 추가됨
- 표시할 네트워크의 상세 정보 확인 : –no-trunc 옵션
- 네트워크 ID만 확인할 경우 : -q 또는 –quiet 옵션
- 필터링을 하고 싶을 때 : -f 또는 –filter 옵션
- 필터링시 key=value 형태로 지정
| 필터링값 | 설명 |
|---|---|
| driver | 드라이버 지정 |
| id | 네트워크 ID |
| label | 네트워크에 설정된 라벨(label=<Key> 또는 <Key>=<value>로 지정 |
| name | 네트워크명 |
| scope | 네트워크의 스코프(swarm/global/local |
| type | 네트워크의 타입(사용자 정의 및 네트워크 custom/정의 완료 네트워크 builtin) |
네트워크 목록 표시의 필터링 (예제)
$ sudo docker network ls -q --filter driver=bridge
914f387eab6b- 브리지 네트워크의 네트워크 ID만을 목록으로 표시
컨테이너 시작 및 네트워크 확인 - 기본값 (예제)
- 네트워크를 명시적으로 지정하지 않고 Docker 컨테이너를 시작하면 기본값인 ‘bridge” 네트워크로 Docker 컨테이너를 시작
- 네트워크 미지정으로 컨테이너 시작
$ sudo docker container run -itd --name=sample ubuntu:latest
Unable to find image 'ubuntu:latest' locally
latest: Pulling from library/ubuntu
7ddbc47eeb70: Pull complete
c1bbdc448b72: Pull complete
8c3b70e39044: Pull complete
45d437916d57: Pull complete
Digest: sha256:6e9f67fa63b0323e9a1e587fd71c561ba48a034504fb804fd26fd8800039835d
Status: Downloaded newer image for ubuntu:latest
6f5f6f2977d0396a055bb56de9483230600e67259f638b2933c73878a2cfb096- 네트워크 확인
- NetworkID : 브릿지 네트워크 914f387eab6b로 컨테이너가 시작하는 것을 볼 수 있음
$ sudo docker container inspect sample | grep -A 20 'Networks"'
"Networks": {
"bridge": {
"IPAMConfig": null,
"Links": null,
"Aliases": null,
"NetworkID": "914f387eab6bad21aa135f72502af7712546bb9e18171053620452e1024a5e7b",
"EndpointID": "87327fa279458f5d54052b24118294689ca46daa621a6e10651479b0d627fe97",
"Gateway": "172.17.0.1",
"IPAddress": "172.17.0.3",
"IPPrefixLen": 16,
"IPv6Gateway": "",
"GlobalIPv6Address": "",
"GlobalIPv6PrefixLen": 0,
"MacAddress": "02:42:ac:11:00:03",
"DriverOpts": null
}
}
}
}
]네트워크 작성
-
docker network create [옵션] 네트워크
-
주요 옵션
- --driver, -d : 네트워크 브리지 또는 오버레이(overlay) & 커스텀 네트워크 , 기본값은 bridge
오버레이 네트워크 : 여러 개의 호스트에 걸쳐있는 네트워크
- --ip-range : 컨테이너에 할당하는 IP 주소의 범위 지정
- --subnet : 서브넷을 CIDR 형식으로 지정
- --ipv6 : ipv6 네트워크를 유효화할지 말지(true/false)
- -label : 네트워크에 설정하는 라벨
브리지 네트워크 작성 (예제)
-
web-network라는 이름의 브리지 네트워크를 작성
참고로 --driver 옵션에서 지정할수 있는 네트워크 드라이버 키값은 'bridge' 또는 'overlay'입니다. 또한 커스텀 네트워크 드라이버도 사용할 수 있습니다. 오버레이 네트워크는 여러개의 호스트에 걸쳐있는 네트워크를 말합니다.
$ sudo docker network create --driver=bridge web-network
ff20a5e471efedc350cf63c0bbcd4619afa8cd969993aa9686a8fdf3c70624d1- 작성한 네트워크 확인
$ sudo docker network ls
NETWORK ID NAME DRIVER SCOPE
914f387eab6b bridge bridge local
c8fa1e69139e host host local
478c12382ce4 none null local
ff20a5e471ef web-network bridge local- 사용자가 생성한 네트워크는 기본 브리지 네트워크와 이름 해결 구조가 다름
- 사용자 정의 네트워크를 사용하는 편이 보다 유연하고 쉽게 네트워크 구성 관리를 할 수 있음
- 기본 브리지 네트워크 사용 : link 기능과 같이 /etc/hosts 파일에 의존적
- 사용자 정의 네트워크 : 내장된 DNS 서버에 의해 이름 해결
네트워크 연결
문법
docker network connect [옵션] 네트워크 컨테이너
- Docker 컨테이너를 Docker 네트워크에 연결
docker network disconnect [옵션] 네트워크 컨테이너
- 네트워크에서 연결을 해제할 때
network connect 명령어 주요 옵션
- --ip : IPv4 주소
- --ip6 : IPv6 주소
- --alias : 별칭명
- --link : 다른 컨테이너에 의한 링크
네트워크에 대한 연결 (예제)
- 네트워크에 대한 연결
- sample 컨테이너를 web-network 네트워크에 연결
- 연결하고나면 동일 네트워크상 다른 컨테이너와 통신 가능
- 연결은 IP 주소 뿐만 아니라 컨테이너명 혹은 컨테이너 ID도 그대로 사용할 수 있음
$ sudo docker network connect web-network sample- 컨테이너 네트워크 확인
$ sudo docker container inspect sample | grep -A 20 'web-'
"web-network": {
"IPAMConfig": {},
"Links": null,
"Aliases": [
"6f5f6f2977d0"
],
"NetworkID": "ff20a5e471efedc350cf63c0bbcd4619afa8cd969993aa9686a8fdf3c70624d1",
"EndpointID": "43556adf01f64c1b39b25dc9ec662b3a981d47dd7e6c52eba2f98aa0c4a81a29",
"Gateway": "172.19.0.1",
"IPAddress": "172.19.0.2",
"IPPrefixLen": 16,
"IPv6Gateway": "",
"GlobalIPv6Address": "",
"GlobalIPv6PrefixLen": 0,
"MacAddress": "02:42:ac:13:00:02",
"DriverOpts": {}
}
}
}
}
]네트워크를 지정한 컨테이너 시작 (예제)
$ sudo docker container run -itd --name sample2 --net=web-network nginx
9d4977cbb33a4e50bd00169a702b019f79e8cbfbbff469c123bf50e73a9de8f3- 컨테이너 시작 시 네트워크 연결하기
네트워크에 대한 연결 해제 (예제)
$ sudo docker network disconnect web-network sample
$ docker container inspect sample | grep -A 20 'web-'- 네트워크 연결 해제
네트워크 상세 정보 확인
- docker network inspect [옵션] 네트워크
네트워크 상세 정보 표시 (예제)
- web-network 이름의 네트워크 상세 정보 표시
- 서브넷 : 172.19.0.0/16
- 게이트웨이 : 172.19.0.1
- 1개의 컨테이너 가동중 - sample2(172.19.0.3)
$ sudo docker network inspect web-network
[
{
"Name": "web-network",
"Id": "ff20a5e471efedc350cf63c0bbcd4619afa8cd969993aa9686a8fdf3c70624d1",
"Created": "2019-10-21T05:54:45.972527483+09:00",
"Scope": "local",
"Driver": "bridge",
"EnableIPv6": false,
"IPAM": {
"Driver": "default",
"Options": {},
"Config": [
{
"Subnet": "172.19.0.0/16",
"Gateway": "172.19.0.1"
}
]
},
"Internal": false,
"Attachable": false,
"Ingress": false,
"ConfigFrom": {
"Network": ""
},
"ConfigOnly": false,
"Containers": {
"9d4977cbb33a4e50bd00169a702b019f79e8cbfbbff469c123bf50e73a9de8f3": {
"Name": "sample2",
"EndpointID": "7400c7ae460f5d11058a322388f60da77210d6b112f0f150847615d8b36429a5",
"MacAddress": "02:42:ac:13:00:03",
"IPv4Address": "172.19.0.3/16",
"IPv6Address": ""
}
},
"Options": {},
"Labels": {}
}
]네트워크 삭제
- docker network rm [옵션] 네트워크
네트워크 삭제 (예제)
- 선작업) docker network disconnect 명령을 이용하여 연결 중인 모든 컨테이너와 연결을 해제
// 사용중인 건이 있을 경우 다음과 같이 에러가 발생함
$ sudo docker network rm web-network
Error response from daemon: error while removing network: network web-network id ff20a5e471efedc350cf63c0bbcd4619afa8cd969993aa9686a8fdf3c70624d1 has active endpoints
// 연결해제
$ sudo docker network disconnect web-network 9d4977cbb33a- 네트워크 삭제
$ sudo docker network rm web-network
web-network
어제보다 오늘 그리고 오늘 보다 내일...