跳至文章
Shemol安裝容器執行時
流程记录 / 云原生

安裝容器執行時

我們要先安裝 containerd,然後安裝 k8s,接著部署 kubeedge、edgemesh 以及 sedna,跑一個官方示例的聯合推理應用案例。

實驗環境:Debian GNU/Linux 12 (bookworm) x86_64,提前配置好了代理和 apt 鏡像源,配置好代理方便從 github 上下載檔案。
一點可能有用的建議:在進行分割時盡量將 /var 分割區分配空間多一點(至少 20G),/var 是存放鏡像和日誌的地方。

安裝 containerd

官方安裝文件:https://github.com/containerd/containerd/blob/main/docs/getting-started.md

安裝 containerd

1.下載 containerd 並安裝到指定路徑

shell
wget -c <https://github.com/containerd/containerd/releases/download/v1.7.18/containerd-1.7.18-linux-amd64.tar.gz>

sudo tar Cxzvf /usr/local/bin/ containerd-1.7.18-linux-amd64.tar.gz

2.透過 systemd 啟動 containerd

shell
wget -c <https://raw.githubusercontent.com/containerd/containerd/main/containerd.service>

sudo mkdir -p /usr/local/lib/systemd/system/

sudo cp containerd.service /usr/local/lib/systemd/system/

sudo chmod 755 /usr/local/lib/systemd/system/containerd.service

sudo systemctl daemon-reload

sudo systemctl enable --now containerd

3.配置 containerd

取得預設配置內容

shell
sudo mkdir -p /etc/containerd/

containerd config default | sudo tee /etc/containerd/config.toml

(1)修改 config.toml 中的 sandbox_image(可選),systemd_cgroup,SystemdCgroup 等屬性:

toml
# 将 sandbox_image = "registry.k8s.io/pause:3.6" 调整为
sandbox_image = "registry.cn-hangzhou.aliyuncs.com/google_containers/pause:3.9"

# 将 [plugins."io.containerd.grpc.v1.cri"] 下的 systemd_cgroup = false 注释掉
# systemd_cgroup = false

# 将 [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options] 下的 SystemdCgroup = false 调整为 true
SystemdCgroup = true

這裡 sandbox_image 版本變成 3.8 是根據 Kubernetes 的版本來的(如果不是安裝 Kubernetes,可以不用修改):

shell
sudo kubeadm config images list --kubernetes-version v1.28.10
registry.k8s.io/kube-apiserver:v1.28.10
registry.k8s.io/kube-controller-manager:v1.28.10
registry.k8s.io/kube-scheduler:v1.28.10
registry.k8s.io/kube-proxy:v1.28.10
registry.k8s.io/pause:3.9
registry.k8s.io/etcd:3.5.12-0
registry.k8s.io/coredns/coredns:v1.10.1

(2)另外,如果從本地私有倉庫拉取鏡像,可能會遇到如下錯誤:Unable to pull image from insecure registry, http: server gave HTTP response to HTTPS client,為此我們需要對這個私有倉庫(比如這裡的 http://192.168.10.127:5000)進行安全設定:(這個筆者沒有遇到這個問題,但考慮到可能有讀者會遇到,還是從參考文章中複製了下來)

toml
# 在 [plugins."io.containerd.grpc.v1.cri".registry] 下对 mirrors 和 mirrors 做如下配置
[plugins."io.containerd.grpc.v1.cri".registry.mirrors]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."192.168.10.127:5000"]
    endpoint = ["<https://192.168.10.127:5000>", "<http://192.168.10.127:5000>"]
[plugins."io.containerd.grpc.v1.cri".registry.configs]
  [plugins."io.containerd.grpc.v1.cri".registry.configs."192.168.10.127:5000".tls]     insecure_skip_verify = true

注意空格。

(3)個人建議新增國內鏡像源方便鏡像拉取。

阿里雲鏡像加速:https://cr.console.aliyun.com/cn-hangzhou/instances/mirrors

華為雲鏡像加速:容器->容器鏡像服務 SWR->鏡像資源->鏡像中心->鏡像加速器

toml
[plugins."io.containerd.grpc.v1.cri".registry.mirrors] #主要在这下面配置镜像加速服务
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
    endpoint=["https://****.mirror.aliyuncs.com","https://****.mirror.swr.myhuaweicloud.com"]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."registry.k8s.io"]
    endpoint=["https://****.mirror.aliyuncs.com","https://****.mirror.swr.myhuaweicloud.com"]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."192.168.10.127:5000"]
    endpoint = ["<https://192.168.10.127:5000>", "<http://192.168.10.127:5000>"]

修改後的樣例(記得把鏡像加速的地址改成自己的):

toml
disabled_plugins = []
imports = []
oom_score = 0
plugin_dir = ""
required_plugins = []
root = "/var/lib/containerd"
state = "/run/containerd"
temp = ""
version = 2

[cgroup]
  path = ""

[debug]
  address = ""
  format = ""
  gid = 0
  level = ""
  uid = 0

[grpc]
  address = "/run/containerd/containerd.sock"
  gid = 0
  max_recv_message_size = 16777216
  max_send_message_size = 16777216
  tcp_address = ""
  tcp_tls_ca = ""
  tcp_tls_cert = ""
  tcp_tls_key = ""
  uid = 0

[metrics]
  address = ""
  grpc_histogram = false

[plugins]

  [plugins."io.containerd.gc.v1.scheduler"]
    deletion_threshold = 0
    mutation_threshold = 100
    pause_threshold = 0.02
    schedule_delay = "0s"
    startup_delay = "100ms"

  [plugins."io.containerd.grpc.v1.cri"]
    device_ownership_from_security_context = false
    disable_apparmor = false
    disable_cgroup = false
    disable_hugetlb_controller = true
    disable_proc_mount = false
    disable_tcp_service = true
    enable_selinux = false
    enable_tls_streaming = false
    enable_unprivileged_icmp = false
    enable_unprivileged_ports = false
    ignore_image_defined_volumes = false
    max_concurrent_downloads = 3
    max_container_log_line_size = 16384
    netns_mounts_under_state_dir = false
    restrict_oom_score_adj = false
    sandbox_image = "registry.cn-hangzhou.aliyuncs.com/google_containers/pause:3.9"
    selinux_category_range = 1024
    stats_collect_period = 10
    stream_idle_timeout = "4h0m0s"
    stream_server_address = "127.0.0.1"
    stream_server_port = "0"
    #systemd_cgroup = false
    tolerate_missing_hugetlb_controller = true
    unset_seccomp_profile = ""

    [plugins."io.containerd.grpc.v1.cri".cni]
      bin_dir = "/opt/cni/bin"
      conf_dir = "/etc/cni/net.d"
      conf_template = ""
      ip_pref = ""
      max_conf_num = 1

    [plugins."io.containerd.grpc.v1.cri".containerd]
      default_runtime_name = "runc"
      disable_snapshot_annotations = true
      discard_unpacked_layers = false
      ignore_rdt_not_enabled_errors = false
      no_pivot = false
      snapshotter = "overlayfs"

      [plugins."io.containerd.grpc.v1.cri".containerd.default_runtime]
        base_runtime_spec = ""
        cni_conf_dir = ""
        cni_max_conf_num = 0
        container_annotations = []
        pod_annotations = []
        privileged_without_host_devices = false
        runtime_engine = ""
        runtime_path = ""
        runtime_root = ""
        runtime_type = ""

        [plugins."io.containerd.grpc.v1.cri".containerd.default_runtime.options]

      [plugins."io.containerd.grpc.v1.cri".containerd.runtimes]

        [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc]
          base_runtime_spec = ""
          cni_conf_dir = ""
          cni_max_conf_num = 0
          container_annotations = []
          pod_annotations = []
          privileged_without_host_devices = false
          runtime_engine = ""
          runtime_path = ""
          runtime_root = ""
          runtime_type = "io.containerd.runc.v2"

          [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
            BinaryName = ""
            CriuImagePath = ""
            CriuPath = ""
            CriuWorkPath = ""
            IoGid = 0
            IoUid = 0
            NoNewKeyring = false
            NoPivotRoot = false
            Root = ""
            ShimCgroup = ""
            SystemdCgroup = true

      [plugins."io.containerd.grpc.v1.cri".containerd.untrusted_workload_runtime]
        base_runtime_spec = ""
        cni_conf_dir = ""
        cni_max_conf_num = 0
        container_annotations = []
        pod_annotations = []
        privileged_without_host_devices = false
        runtime_engine = ""
        runtime_path = ""
        runtime_root = ""
        runtime_type = ""

        [plugins."io.containerd.grpc.v1.cri".containerd.untrusted_workload_runtime.options]

    [plugins."io.containerd.grpc.v1.cri".image_decryption]
      key_model = "node"

    [plugins."io.containerd.grpc.v1.cri".registry]
      config_path = ""

      [plugins."io.containerd.grpc.v1.cri".registry.auths]

      [plugins."io.containerd.grpc.v1.cri".registry.mirrors]
        [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
          endpoint=["https://*.mirror.aliyuncs.com","https://*.mirror.swr.myhuaweicloud.com"]
        [plugins."io.containerd.grpc.v1.cri".registry.mirrors."registry.k8s.io"]
          endpoint=["https://*.mirror.aliyuncs.com","https://*.mirror.swr.myhuaweicloud.com"]
        [plugins."io.containerd.grpc.v1.cri".registry.mirrors."192.168.10.127:5000"]
          endpoint = ["<https://192.168.10.127:5000>", "<http://192.168.10.127:5000>"]

      [plugins."io.containerd.grpc.v1.cri".registry.configs]
        [plugins."io.containerd.grpc.v1.cri".registry.configs."192.168.10.127:5000".tls]
          insecure_skip_verify = true

      [plugins."io.containerd.grpc.v1.cri".registry.headers]

    [plugins."io.containerd.grpc.v1.cri".x509_key_pair_streaming]
      tls_cert_file = ""
      tls_key_file = ""

  [plugins."io.containerd.internal.v1.opt"]
    path = "/opt/containerd"

  [plugins."io.containerd.internal.v1.restart"]
    interval = "10s"

  [plugins."io.containerd.internal.v1.tracing"]
    sampling_ratio = 1.0
    service_name = "containerd"

  [plugins."io.containerd.metadata.v1.bolt"]
    content_sharing_policy = "shared"

  [plugins."io.containerd.monitor.v1.cgroups"]
    no_prometheus = false

  [plugins."io.containerd.runtime.v1.linux"]
    no_shim = false
    runtime = "runc"
    runtime_root = ""
    shim = "containerd-shim"
    shim_debug = false

  [plugins."io.containerd.runtime.v2.task"]
    platforms = ["linux/arm64/v8"]
    sched_core = false

  [plugins."io.containerd.service.v1.diff-service"]
    default = ["walking"]

  [plugins."io.containerd.service.v1.tasks-service"]
    rdt_config_file = ""

  [plugins."io.containerd.snapshotter.v1.aufs"]
    root_path = ""

  [plugins."io.containerd.snapshotter.v1.btrfs"]
    root_path = ""

  [plugins."io.containerd.snapshotter.v1.devmapper"]
    async_remove = false
    base_image_size = ""
    discard_blocks = false
    fs_options = ""
    fs_type = ""
    pool_name = ""
    root_path = ""

  [plugins."io.containerd.snapshotter.v1.native"]
    root_path = ""

  [plugins."io.containerd.snapshotter.v1.overlayfs"]
    root_path = ""
    upperdir_label = false

  [plugins."io.containerd.snapshotter.v1.zfs"]
    root_path = ""

  [plugins."io.containerd.tracing.processor.v1.otlp"]
    endpoint = ""
    insecure = false
    protocol = ""

[proxy_plugins]

[stream_processors]

  [stream_processors."io.containerd.ocicrypt.decoder.v1.tar"]
    accepts = ["application/vnd.oci.image.layer.v1.tar+encrypted"]
    args = ["--decryption-keys-path", "/etc/containerd/ocicrypt/keys"]
    env = ["OCICRYPT_KEYPROVIDER_CONFIG=/etc/containerd/ocicrypt/ocicrypt_keyprovider.conf"]
    path = "ctd-decoder"
    returns = "application/vnd.oci.image.layer.v1.tar"

  [stream_processors."io.containerd.ocicrypt.decoder.v1.tar.gzip"]
    accepts = ["application/vnd.oci.image.layer.v1.tar+gzip+encrypted"]
    args = ["--decryption-keys-path", "/etc/containerd/ocicrypt/keys"]
    env = ["OCICRYPT_KEYPROVIDER_CONFIG=/etc/containerd/ocicrypt/ocicrypt_keyprovider.conf"]
    path = "ctd-decoder"
    returns = "application/vnd.oci.image.layer.v1.tar+gzip"

[timeouts]
  "io.containerd.timeout.bolt.open" = "0s"
  "io.containerd.timeout.shim.cleanup" = "5s"
  "io.containerd.timeout.shim.load" = "5s"
  "io.containerd.timeout.shim.shutdown" = "3s"
  "io.containerd.timeout.task.state" = "2s"

[ttrpc]
  address = ""
  gid = 0
  uid = 0

重啟 containerd

shell
sudo systemctl restart containerd

此外,還建議為 containerd 配置代理(需要事先已經配置好電腦代理):

shell
vim /lib/systemd/system/containerd.service

增加以下內容(根據自己的代理進行調整,筆者使用的是 clash):

plain text
Environment="HTTP_PROXY=http://127.0.0.1:7890"
Environment="HTTPS_PROXY=http://127.0.0.1:7890"
Environment="NO_PROXY =10.96.0.0/16,127.0.0.1,192.168.0.0/16,localhost"

安裝 runc

shell
wget -c <https://github.com/opencontainers/runc/releases/download/v1.1.12/runc.amd64>

sudo install -m 755 runc.amd64 /usr/local/sbin/runc

我在操作的過程中發現還需要把 /usr/local/sbin/ 加入到環境變數中,這個請自行搜尋方法。

安裝 CNI plugins

shell
sudo mkdir -p /opt/cni/bin

sudo tar Cxzvf /opt/cni/bin cni-plugins-linux-amd64-v1.4.1.tgz

安裝客戶端

因為是配合 k8s 使用,所以選擇安裝 crictl。

shell
VERSION="v1.30.0"

wget <https://github.com/kubernetes-sigs/cri-tools/releases/download/$VERSION/crictl-$VERSION-linux-amd64.tar.gz>

sudo tar zxvf crictl-$VERSION-linux-amd64.tar.gz -C /usr/local/bin

配置:

shell
cat << EOF | sudo tee /etc/crictl.yaml runtime-endpoint: unix:///run/containerd/containerd.sock image-endpoint: unix:///run/containerd/containerd.sock timeout: 2 debug: true pull-image-on-create: false EOF

參考文章

  • 容器執行時 containerd:https://demonlee.tech/archives/2212001
  • Containerd 配置國內鏡像源:https://juejin.cn/post/7312330825206693939
  • 簡述關於 containerd 設定代理:https://blog.51cto.com/u_15343792/5142108