Alpine Linux - User contributions [en]

Docker

2020-09-17T16:24:37Z

Ccornelius:

== Installation ==

The Docker package is in the 'Community' repository. See [[Alpine_Linux_package_management]] how to add a repository.

apk add docker

Connecting to the Docker daemon through its socket requires you to add yourself to the `docker` group.

addgroup username docker

To start the Docker daemon at boot, see [[Alpine_Linux_Init_System]].

rc-update add docker boot
service docker start

{{Note|On older version of Alpine Linux with older version of docker you'll also need to disable some kernel security flags in order to build images:}}

sysctl -w kernel.grsecurity.chroot_deny_chmod=0
sysctl -w kernel.grsecurity.chroot_deny_mknod=0

For more information, have a look at the [https://github.com/docker/docker/issues/20303 corresponding Github issue].

Anyway, this weakening of security is not necessary to do with Alpine 3.4.x and Docker 1.12 as of August 2016 anymore.

=== Docker Compose ===

'docker-compose' is in 'Community' repository since Alpine Linux >= 3.10.

apk add docker-compose

For older releases, do:

'''To install docker-compose, first install pip:'''

apk add py-pip python3-dev libffi-dev openssl-dev gcc libc-dev make
pip3 install docker-compose</code>

== Isolate containers with a user namespace ==
<pre>
adduser -SDHs /sbin/nologin dockremap
addgroup -S dockremap
echo dockremap:$(cat /etc/passwd|grep dockremap|cut -d: -f3):65536 >> /etc/subuid
echo dockremap:$(cat /etc/passwd|grep dockremap|cut -d: -f4):65536 >> /etc/subgid
</pre>

and add in '''/etc/docker/daemon.json'''

<pre>
{
"userns-remap": "dockremap"
}
</pre>

''You may also consider these options : '''
"experimental": false,
"live-restore": true,
"ipv6": false,
"icc": false,
"no-new-privileges": false'''''

You will find all possible configurations here[https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file].

== Example: How to install docker from Arch ==

https://wiki.archlinux.org/index.php/Docker

== "WARNING: No {swap,memory} limit support" ==

You may, probably, encounter this message by executing <code>docker info</code>.
To correct this situation we have to enable the <code>cgroup_enable=memory swapaccount=1</code>

==== Alpine 3.8 ====
Well I'm not sure it wasn't the case before but for sure with Alpine 3.8 you must config cgroups properly

'''''Warning''''': This seems ''not'' to work with Alpine 3.9 and Docker 18.06. Follow the instructions for grub or extlinux below instead.

<pre>echo "cgroup /sys/fs/cgroup cgroup defaults 0 0" >> /etc/fstab</pre>
<pre>
cat >> /etc/cgconfig.conf <<EOF
mount {
cpuacct = /cgroup/cpuacct;
memory = /cgroup/memory;
devices = /cgroup/devices;
freezer = /cgroup/freezer;
net_cls = /cgroup/net_cls;
blkio = /cgroup/blkio;
cpuset = /cgroup/cpuset;
cpu = /cgroup/cpu;
}
EOF
</pre>

=== Grub ===
Well; if you use Grub it is like any other linux and you just have to add the cgroup condition into <code>/etc/default/grub</code>, then upgrade your grub

<pre>GRUB_CMDLINE_LINUX_DEFAULT="... e=memory swapaccount=1"</pre>

=== Extlinux ===
With Extlinux you also add the cgroup condition but inside <code>/etc/update-extlinux.conf</code>

<pre>default_kernel_opts="... cgroup_enable=memory swapaccount=1"</pre>

than update the config and reboot

<code>update-extlinux</code>

== '''How to use docker''' ==

The best documentation for how to use Docker and create containers is at the main docker site. Adding anything more to it here would be redundant.

'''http://docs.docker.com/'''

if you create an account at docker.com you can browse through other user's images and learn from the syntax in contributor's dockerfiles.

Official Docker image files are denoted by a blue ribon on the website.

== See also ==
* [https://www.erianna.com/creating-a-alpine-linux-repository/ Creating & Hosting an Alpine Linux Package Repository for Docker Packages]
* [[Running Alpine in a Docker Container]]

[[Category:Virtualization]]

Open-vm-tools

2020-09-17T16:23:43Z

Ccornelius: /* Changes */

When installing Alpine Linux on an ESXi or VSphere system you definitely want to enable the hypervisor tools. The good news is that Alpine has this package ready to go! Open-VM-Tools provides the VMWare hypervisor info from Alpine and other Linux. https://github.com/vmware/open-vm-tools

=== Changes ===

Since alpine 3.12 the open-vm-tools version 11 was split into packages:

* open-vm-tools
** open-vm-tools-deploypkg
** open-vm-tools-guestinfo
** open-vm-tools-static
** open-vm-tools-vmbackup

guestinfo is required for [https://docs.vmware.com/en/VMware-NSX-Data-Center-for-vSphere/6.3/com.vmware.nsx.admin.doc/GUID-B0CD973F-67DD-49D1-8B9E-8C404F92E528.html IP Discovery] to work.

deploypkg provides support for Guest OS Customization

=== Installation ===

apk add open-vm-tools
apk add open-vm-tools-guestinfo
apk add open-vm-tools-deploypkg

=== Start once ===
<code>rc-service open-vm-tools start</code>

=== Add to boot ===
<code>rc-update add open-vm-tools boot</code>

=== Verify in ESXi/VSphere its working ===

Look for: VMware Tools (Running, version:xxxx)

<gallery>
Working Tools.png|Working ESXi Tools
</gallery>

Open-vm-tools

2020-09-17T16:21:38Z

Ccornelius: /* Installation */

When installing Alpine Linux on an ESXi or VSphere system you definitely want to enable the hypervisor tools. The good news is that Alpine has this package ready to go! Open-VM-Tools provides the VMWare hypervisor info from Alpine and other Linux. https://github.com/vmware/open-vm-tools

=== Changes ===

Since alpine 3.12 the open-vm-tools version 11 was split into packages:

* open-vm-tools
** open-vm-tools-deploypkg
** open-vm-tools-guestinfo
** open-vm-tools-static
** open-vm-tools-vmbackup

DeployPkg provides support for Guest Customization

=== Installation ===

apk add open-vm-tools
apk add open-vm-tools-guestinfo
apk add open-vm-tools-deploypkg

=== Start once ===
<code>rc-service open-vm-tools start</code>

=== Add to boot ===
<code>rc-update add open-vm-tools boot</code>

=== Verify in ESXi/VSphere its working ===

Look for: VMware Tools (Running, version:xxxx)

<gallery>
Working Tools.png|Working ESXi Tools
</gallery>

Open-vm-tools

2020-09-17T16:20:23Z

Ccornelius: /* Installation */

When installing Alpine Linux on an ESXi or VSphere system you definitely want to enable the hypervisor tools. The good news is that Alpine has this package ready to go! Open-VM-Tools provides the VMWare hypervisor info from Alpine and other Linux. https://github.com/vmware/open-vm-tools

=== Changes ===

Since alpine 3.12 the open-vm-tools version 11 was split into packages:

* open-vm-tools
** open-vm-tools-deploypkg
** open-vm-tools-guestinfo
** open-vm-tools-static
** open-vm-tools-vmbackup

DeployPkg provides support for Guest Customization

=== Installation ===
<code>
apk add open-vm-tools
apk add open-vm-tools-guestinfo
apk add open-vm-tools-deploypkg
</code>

=== Start once ===
<code>rc-service open-vm-tools start</code>

=== Add to boot ===
<code>rc-update add open-vm-tools boot</code>

=== Verify in ESXi/VSphere its working ===

Look for: VMware Tools (Running, version:xxxx)

<gallery>
Working Tools.png|Working ESXi Tools
</gallery>

Install Alpine on VMware Workstation

2020-09-17T16:17:33Z

Ccornelius:

There's at least 2 ways you can setup Alpine on a VMware box.

== Option 1: sys mode, traditional hard-disk install (preferable for a dev box) ==

# Create a virtual machine (linux, other 3.x kernel 64 bit)
## add a hard drive, with the size depending on your work
## add a cdrom to the vm that points to the alpine iso you downloaded (alpine-virt x86_64)
# boot into the vm (username: root)
## run `alpine-install`
## choose `sys` when asked about the disk mode (this will permanently install Alpine on the disk)
## choose the default disk mounted by VMware
## reboot after the installation is complete

== Option 2: USB mode, no data preserved between reboots ==

# Create a virtual machine (linux, other 3.x kernel 64 bit)
## add a minimal hard drive, 100MB for saving configs, (like an usb stick)
## add a cdrom to the vm that points to the alpine iso you downloaded (alpine-virt x86_64)
# boot into the vm
# press f2 on boot to enter the BIOS
## change the boot order so that it boots from cd, then hd, then floppy (or whatever - as long as cd is first)
# boot the machine
# now run the following commands:
## mkfs.vfat /dev/sda
## mount /dev/sda /media/usb (Or try: mount -t vfat /dev/sda /media/usb)
## grep /dev/sda /proc/mounts >> /etc/fstab
## setup-alpine (select no disk, save configs to 'usb')
## lbu ci usb

If the VM hangs at the boot prompt, reboot the VM, and when the boot prompt appears again, type <tt>pax_nouderef</tt> (i.e. append it to the kernel options) and press Enter. This should allow normal boot-up. <br />

Now you should be able to reboot and it should retain your settings because they were saved to your "usb"-disk.

== VMware Tools ==

More info on this page: [[Open-vm-tools]]

For VMware Tools support you need to install the package [https://pkgs.alpinelinux.org/package/edge/main/x86_64/open-vm-tools open-vm-tools].

[[Category:Virtualization]]

Open-vm-tools

2020-09-17T16:14:53Z

Ccornelius:

When installing Alpine Linux on an ESXi or VSphere system you definitely want to enable the hypervisor tools. The good news is that Alpine has this package ready to go! Open-VM-Tools provides the VMWare hypervisor info from Alpine and other Linux. https://github.com/vmware/open-vm-tools

=== Changes ===

Since alpine 3.12 the open-vm-tools version 11 was split into packages:

* open-vm-tools
** open-vm-tools-deploypkg
** open-vm-tools-guestinfo
** open-vm-tools-static
** open-vm-tools-vmbackup

DeployPkg provides support for Guest Customization

=== Installation ===
<code>apk add open-vm-tools open-vm-tools-guestinfo open-vm-tools-deploypkg</code>

=== Start once ===
<code>rc-service open-vm-tools start</code>

=== Add to boot ===
<code>rc-update add open-vm-tools boot</code>

=== Verify in ESXi/VSphere its working ===

Look for: VMware Tools (Running, version:xxxx)

<gallery>
Working Tools.png|Working ESXi Tools
</gallery>