v0.1.0-dev-7: Enable legacy support workaround (#9)

Changelog (v0.1.0-dev-7)

• Adding image reference alternative feature to handle containerd version under 1.7-beta-1
  • Since the _default host feature isn't backported to older versions of containerd, the previous implementations can't handle dynamic enablement. To address this issue, the mirror now has the ability to handle image references in this format azurecr.io/_tenant_{registry}/{repo}:{tag}. This will be translated into {registry}.azurecr.io/{repo}:{tag} by the mirror which will then go through the normal dynamic enablement flow.

Notes

Developer version of acr-mirror service. After installing, you can install and configure overlaybd w/

(as sudo)

/opt/acr/tools/overlaybd/install.sh
/opt/acr/tools/overlaybd/enable-http-auth.sh
/opt/acr/tools/overlaybd/enable.sh

This will,

1. Download and install overlaybd-tcmu and overlaybd-snapshotter, enable kernel features, and configure containerd
2. Enable overlaybd-tcmu to authenticate using the acr-mirror as the access provider
3. Enable the systemd unit files for overlaybd services, and start them
4. Restart containerd

If the acr-mirror service is running in an environment other than AKS, then installing az-cli and running az login once is required (for example on your dev box).

To remove the package run,

apt-get remove acr-mirror

This will delete the /opt/acr folder but will not uninstall overlaybd packages. They must be removed individually.

Install script,

Ubuntu 18.04

#!/bin/bash
set -e

pushd /tmp || exit 1
wget 'https://github.com/juliusl/lifec_registry/releases/download/v0.1.0-dev-7/acr-mirror-1804-v0.1.0-dev-7.deb'
sudo apt-get install './acr-mirror-1804-v0.1.0-dev-7.deb' -y
rm './acr-mirror-1804-v0.1.0-dev-7.deb'
popd

# These libraries are needed for overlaybd-tcmu
sudo apt install libaio1 libnl-3-dev libnl-genl-3-dev
sudo /opt/acr/tools/overlaybd/install.sh
sudo /opt/acr/tools/overlaybd/enable-http-auth.sh
sudo /opt/acr/tools/overlaybd/enable.sh

Ubuntu 20.04

#!/bin/bash
set -e

pushd /tmp || exit 1
wget 'https://github.com/juliusl/lifec_registry/releases/download/v0.1.0-dev-7/acr-mirror-2004-v0.1.0-dev-7-0d5b9.deb'
sudo apt-get install './acr-mirror-2004-v0.1.0-dev-7-0d5b9.deb' -y
rm './acr-mirror-2004-v0.1.0-dev-7-0d5b9.deb'
popd

sudo /opt/acr/tools/overlaybd/install.sh
sudo /opt/acr/tools/overlaybd/enable-http-auth.sh
sudo /opt/acr/tools/overlaybd/enable.sh

ACR Mirror - Dev Release

Developer version of acr-mirror service. After installing, you can install and configure overlaybd w/

(as sudo)

/opt/acr/tools/overlaybd/install.sh
/opt/acr/tools/overlaybd/enable-http-auth.sh
/opt/acr/tools/overlaybd/enable.sh

This will,

1. Download and install overlaybd-tcmu and overlaybd-snapshotter, enable kernel features, and configure containerd
2. Enable overlaybd-tcmu to authenticate using the acr-mirror as the access provider
3. Enable the systemd unit files for overlaybd services, and start them
4. Restart containerd

If the acr-mirror service is running in an environment other than AKS, then installing az-cli and running az login once is required (for example on your dev box).

To remove the package run,

apt-get remove acr-mirror

This will delete the /opt/acr folder but will not uninstall overlaybd packages. They must be removed individually.

Install script,

Ubuntu 18.04

#!/bin/bash
set -e

pushd /tmp || exit 1
wget 'https://github.com/juliusl/lifec_registry/releases/download/v0.1.0-dev-5/acr-mirror-1804-v0.1.0-dev-5-c098b.deb'
sudo apt-get install './acr-mirror-1804-v0.1.0-dev-5-c098b.deb' -y
rm './acr-mirror-1804-v0.1.0-dev-5-c098b.deb'
popd

# These libraries are needed for overlaybd-tcmu
sudo apt install libaio1 libnl-3-dev libnl-genl-3-dev
sudo /opt/acr/tools/overlaybd/install.sh
sudo /opt/acr/tools/overlaybd/enable-http-auth.sh
sudo /opt/acr/tools/overlaybd/enable.sh

Ubuntu 20.04

#!/bin/bash
set -e

pushd /tmp || exit 1
wget 'https://github.com/juliusl/lifec_registry/releases/download/v0.1.0-dev-5/acr-mirror-2004-v0.1.0-dev-5-c098b.deb'
sudo apt-get install './acr-mirror-2004-v0.1.0-dev-5-c098b.deb' -y
rm './acr-mirror-2004-v0.1.0-dev-5-c098b.deb'
popd

sudo /opt/acr/tools/overlaybd/install.sh
sudo /opt/acr/tools/overlaybd/enable-http-auth.sh
sudo /opt/acr/tools/overlaybd/enable.sh