| Description | Value |
|---|---|
| Created | 18.02.2020 |
| Last modified | 19.11.2020 |
| Controller | AXC F 1152; AXC F 2152; AXC F 3152 |
| Firmware | 2021.0 LTS |
iptables-nftis now part of the FW image- Publish as APP in PLCnext Store
- Added docker as installation option
- Removed the version selection (only the default versions of balena and docker are stable)
- Fixed docker-dompose
- Fixed issue with the PLCnext firewall and WBM
For the difference between Docker and balenaEngine, see https://www.balena.io/engine/
Known issues:
- Factory reset does not remove application images and cache.
- server certificate verification failed due to an incorrect system time
Read the Workarounds chapter for fixes.
The following chapters provides an introduction and first steps with Balena-Engine an IoT focused Docker like container technology on a PLCnext control.
For more Information about Balena-Engine visit the website and the GitHub project.
For installation you need to be root user:
To change to root:
suTo set the password from root
sudo passwd rootFor installation:
# Download the Project
git clone https://github.com/PLCnext/Docker_GettingStarted.git
# Execute Setup.sh in archive
cd Docker_GettingStarted
chmod +x setup.sh
./setup.shLogin to the terminal, change to root and remove the folder manually
rm -rf /media/rfs/rw/var/lib/balenaLogin to the terminal and set the system clock to the correct time.
sudo date -s "YYYY-MM-DD hh:mm:ss"More information on the topic system time can be found here in the PLCnext Info Center.
You can get support or provide suggestion and ideas in the forum of the PLCnext Community.
All OCI compatible images can be used in combination with balena, especially docker images.
For images see: https://hub.docker.com/
Internet connection is required!
Pull loads an image from a repository and stores it locally. if no complete domain is given, the images on https://hub.docker.com/ are searched automatically.
root@axcf2152:~# balena-engine pull armhf/debianStart creates a container from an image available on the local computer
root@axcf2152:~# balena-engine start armhf/debianThe run command combines pull and start
root@axcf2152:~# balena-engine run armhf/debianThe command -it (interactive with tty) creates a new process in a container. The entry point must also be specified. In the example /bin/bash
root@axcf2152:~# balena-engine run -it debian /bin/bash
# Result: If a container is successfully started
root@9bc6dd4527e0:/#root@9bc6dd4527e0:/# ping 8.8.8.8
# Result:
PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
64 bytes from 8.8.8.8: icmp_seq=1 ttl=55 time=14.6 msWhen closing and restarting containers the runtime data (data that is not part of the image) is lost. If this data is to be retained, it must be stored persistently. See volumes.
root@9bc6dd4527e0:/# exit
# Result:
root@axcf2152:~#Mounting host volumes into the container and test it. A host volume is one way to persist data from a container.
# Create a project folder on the host e.g. /opt/plcnext/test and mount it in the container as /home/test/
root@axcf2152:~# mkdir /opt/plcnext/test
root@axcf2152:~# balena-engine run -it -v /opt/plcnext/test:/home/test/ debian bashAlternative to host volumes, you can use container volumes on your host. There are also other methods to persistently store data from containers, for which various drivers are provided. Besides volumes and folders, central network storage, such as NFS, is often used.
# For use a container volume you need a name instead of directory. Example:
balena-engine run -it -v test:/home/test/ debian bash
# will be create a volume.
# The volumes can be viewed by:
root@axcf2152:~# balena-engine volume ls
# The content of the volume can be inspected via ls on the host system
root@axcf2152:~# ls /media/rfs/rw/var/lib/balena/volumes/test/_dataYou can see an example output on the console.
root@axcf2152:~# balena-engine ps -a
Result:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
4401cdaf0fee armhf/debian "bash" 7 minutes ago Exited (130) 8 seconds ago cranky_mayer
df194ad3f89d debian "bash" 22 minutes ago Exited (0) 21 minutes ago agitated_austin
092fe03508aa nginx "nginx -g 'daemon of…" 33 minutes ago Exited (0) 31 minutes ago magical_antonelli
0dd0b4d84759 registry:2 "/entrypoint.sh /etc…" About an hour ago Up About an hour 5000/tcp, 0.0.0.0:5000->5000/tcp registry_name
2c71de9f0555 portainer/portainer "/portainer" About an hour ago Up About an hour 0.0.0.0:18000->8000/tcp, 0.0.0.0:19000->9000/tcp frosty_mcleanYou can see an example output on the console.
root@axcf2152:~# balena-engine rm 44 (a part of ID-Number: 4401cdaf0fee)
root@axcf2152:~# balena-engine ps -a
Result:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
df194ad3f89d debian "bash" 22 minutes ago Exited (0) 21 minutes ago agitated_austin
092fe03508aa nginx "nginx -g 'daemon of…" 33 minutes ago Exited (0) 31 minutes ago magical_antonelli
0dd0b4d84759 registry:2 "/entrypoint.sh /etc…" About an hour ago Up About an hour 5000/tcp, 0.0.0.0:5000->5000/tcp registry_name
2c71de9f0555 portainer/portainer "/portainer" About an hour ago Up About an hour 0.0.0.0:18000->8000/tcp, 0.0.0.0:19000->9000/tcp frosty_mcleanExamples of interesting projects.
See following Usecase: https://docs.docker.com/registry/deploying/
root@axcf2152:~# balena-engine run -d -p 5000:5000 --name registry_name registry:2Find more information under: https://hub.docker.com/_/nginx
root@axcf2152:~# balena-engine run -d nginxSee Portainer Quick-Start: https://portainer.readthedocs.io/en/stable/deployment.html#quick-start
Result: Open Webbrowser and login into Portainer Docker-Management-Tool (http://192.168.1.10:9000/#/home)
balena-engine run -d -p 8000:8000 -p 9000:9000 -v /var/run/balena-engine.sock:/var/run/balena-engine.sock -v portainer_data_name:/data portainer/portainerbalenaEngine, Moby and Docker are licensed under the Apache License, Version 2.0.
Copyright (c) Phoenix Contact Gmbh & Co KG. All rights reserved.
Licensed under the MIT License.