Project:Docker OpenStackVM: Difference between revisions
DavidNolte (talk | contribs) |
No edit summary |
||
Line 3: | Line 3: | ||
== Setting up the OpenStack VM == | == Setting up the OpenStack VM == | ||
... | 1: Log in to https://rise-control.zib.de with your zib account. | ||
2: In the menu on the left side, go to compute --> key pairs to create or import a key pair. | |||
3: In the menu on the left side, go to compute --> instances and click "Launch instance". | |||
4: Under details, set instance name. | |||
5: Under source, select "No" under "Create New Volume" and select an image by clicking on the arrow on the right. You can also upload new ones in another menu. | |||
6: Under flavor, select a suitable flavor. | |||
7: Under Networks, select mardi. | |||
8: Under Key Pair, select your key pair. | |||
9: Click Launch Instance. | |||
10: In the instance overview, select "Associate floating IP" in the actions menu. | |||
11: You can now connect to the VM if you are in the VPN or at zib with ssh -i key.pem ubuntu@floating_ip | |||
12: If you want to access a website, add "-L 8888:127.0.0.1:8888" to forward the ports. | |||
== Fixing Docker networking problems === | == Fixing Docker networking problems === |
Revision as of 14:11, 1 April 2022
Instructions for using Docker with OpenStack VMs at ZIB
Setting up the OpenStack VM
1: Log in to https://rise-control.zib.de with your zib account.
2: In the menu on the left side, go to compute --> key pairs to create or import a key pair.
3: In the menu on the left side, go to compute --> instances and click "Launch instance".
4: Under details, set instance name.
5: Under source, select "No" under "Create New Volume" and select an image by clicking on the arrow on the right. You can also upload new ones in another menu.
6: Under flavor, select a suitable flavor.
7: Under Networks, select mardi.
8: Under Key Pair, select your key pair.
9: Click Launch Instance.
10: In the instance overview, select "Associate floating IP" in the actions menu.
11: You can now connect to the VM if you are in the VPN or at zib with ssh -i key.pem ubuntu@floating_ip
12: If you want to access a website, add "-L 8888:127.0.0.1:8888" to forward the ports.
Fixing Docker networking problems =
If the internet docker is unreachable on OpenStack VMs, causing commands like apt-get
or curl
to fail (connection timeout
; in cases of "host not reachble" errors this is probably a DNS problem), this may be due to wrong network settings.
Check the MTU settings with ip link
, e.g.,
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN mode DEFAULT group default qlen 1000 link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1450 qdisc fq_codel state UP mode DEFAULT group default qlen 1000 link/ether fa:16:3e:20:67:be brd ff:ff:ff:ff:ff:ff altname enp0s3 altname ens3 3: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN mode DEFAULT group default link/ether 02:42:ae:d6:94:20 brd ff:ff:ff:ff:ff:ff
The docker MTU needs to be less or equal to the physical network setting (here eth0
).
This can be fixed for docker containers by setting by setting in /etc/docker/daemon.json
:
{
"mtu": 1450
}
and for docker-compose
by adding the following to docker-compose-dev.yml
(or *.override.yml
):
networks:
default:
driver: bridge
driver_opts:
com.docker.network.driver.mtu: 1450
SSH port forwarding
In order to access the web services running within the virtual machine via the browser on the host system, use ssh with port forwarding. The following command forwards 127.0.0.1:8080
(it might be required to add the line 127.0.0.1 localhost
to the file /etc/hosts
on the VM) through port 8000 on the host system:
$ ssh -L 8000:127.0.0.1:8080 <vm-user>@<floating-ip>
The service running on port 8080 on the VM is now reachable on the host system at http://localhost:8000
.
workflow recommendations
... TODO ...