Nexus Kullanımı

Kurumunuz Nexus üzerinde docker-proxy repository tanımladıysa, Kubernetes worker node'larında containerd registry mirror yapılandırması yapılır ve Apinizer deployment dosyalarındaki imaj path'leri Nexus adresine göre güncellenir.

bilgi

Bu sayfadaki <NEXUS_HOST> placeholder'ını kurumunuzun registry adresiyle değiştirin (örn. repo.xxx.gov.tr). Path segmenti (docker-proxy vb.) kurumunuzun Nexus yapılandırmasına göre değişebilir.

Containerd Yapılandırması (Önerilen)

Modern Kubernetes kurulumları containerd kullanır. Yapılandırmayı cluster'daki tüm worker node'larda uygulayın.

containerd config.toml dosyasını düzenleyin

sudo su
sudo vi /etc/containerd/config.toml

[plugins."io.containerd.grpc.v1.cri".registry] bölümüne aşağıdaki mirror tanımını ekleyin (<NEXUS_HOST> değerini kurum adresinizle değiştirin):

[plugins."io.containerd.grpc.v1.cri".registry.mirrors."<NEXUS_HOST>"]
  endpoint = ["https://<NEXUS_HOST>"]

Örnek:

[plugins."io.containerd.grpc.v1.cri".registry.mirrors."repo.xxx.gov.tr"]
  endpoint = ["https://repo.xxx.gov.tr"]

containerd servisini yeniden başlatın

sudo systemctl restart containerd
sudo systemctl status containerd

İmaj çekimini doğrulayın

Node üzerinde imajın çekilebildiğini test edin:

sudo ctr images pull <NEXUS_HOST>/docker-proxy/apinizercloud/cache:<APINIZER_VERSION>

Örnek:

sudo ctr images pull repo.xxx.gov.tr/docker-proxy/apinizercloud/cache:2025.07.6

Kubernetes Deployment Yapılandırması

Deployment, StatefulSet veya Helm values dosyalarında image alanını Nexus path yapınıza göre güncelleyin:

image: <NEXUS_HOST>/docker-proxy/apinizercloud/cache:<APINIZER_VERSION>

Örnek:

image: repo.xxx.gov.tr/docker-proxy/apinizercloud/cache:2025.07.6

Diğer Apinizer bileşenleri için aynı path kalıbını kullanın:

# API Manager
image: repo.xxx.gov.tr/docker-proxy/apinizercloud/apimanager:<APINIZER_VERSION>

# Worker
image: repo.xxx.gov.tr/docker-proxy/apinizercloud/worker:<APINIZER_VERSION>

# Integration
image: repo.xxx.gov.tr/docker-proxy/apinizercloud/integration:<APINIZER_VERSION>

# API Portal
image: repo.xxx.gov.tr/docker-proxy/apinizercloud/apiportal:<APINIZER_VERSION>

Docker Runtime Kullanıyorsanız

Docker daemon.json

Eski ortamlarda veya Docker runtime kullanan node'larda /etc/docker/daemon.json dosyasını düzenleyin. Docker kullanan tüm node'larda aynı yapılandırmayı uygulayın.

sudo vi /etc/docker/daemon.json

{
  "data-root": "/docker-data",
  "insecure-registries": ["<NEXUS_HOST>"],
  "registry-mirrors": ["https://<NEXUS_HOST>"],
  "exec-opts": ["native.cgroupdriver=systemd"],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m"
  },
  "storage-driver": "overlay2"
}

sudo systemctl daemon-reload
sudo systemctl restart docker
docker info

not

Sertifika veya imaj çekme hataları için Kubernetes, Docker ve Containerd Sorun Giderme sayfasına bakın.

İlgili Dokümanlar

• Container İmajları ve Registry — senaryo seçimi ve ortak imaj listesi
• Apinizer Sürüm Yükseltme — Yerel Registry — imajları registry'ye push etme ve kubectl set image