# Kubernetes'te alan adı ve otomatik SSL ile uygulama yayınlama · sunucu.com.tr

Kaynak: https://sunucu.com.tr/kubernetes/rehber/alan-adi-ve-ssl · Güncelleme: 2026-11-02

Kümenizde giriş denetleyicisi (sınıf `web`) ve otomatik SSL (`otomatik-ssl`) hazır gelir. Bir uygulamayı `https://uygulama.ornek.com.tr` gibi bir adreste yayınlamak için üç şey yeter: uygulamanın kendisi, DNS kaydı ve bir Ingress tanımı.

## Nasıl çalışır

- Giriş denetleyicisi her düğümde 80 ve 443 portlarını dinler. Gelen isteği alan adına ve yola bakarak doğru Service'e iletir.
- Ingress tanımına `cert-manager.io/cluster-issuer: otomatik-ssl` ek açıklamasını yazdığınızda, kümedeki sertifika sağlayıcısı alan adınız için ücretsiz bir SSL sertifikası ister, `tls.secretName` ile verdiğiniz Secret'a koyar ve süresi dolmadan yeniler.
- Doğrulama HTTP üzerinden yapılır: sertifika otoritesi alan adınızın 80 portuna gelir. Bu yüzden DNS kaydı Ingress'ten önce ya da hemen sonra doğru düğümü göstermelidir.

## 1. Uygulamayı çalıştırın

Örnek olarak küçük bir web uygulamasını iki kopya çalıştırıp küme içinde 80 portundan açıyoruz. Kendi uygulamanızda imaj adını ve portu değiştirin.

Terminal:

```
kubectl apply -f - <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
spec:
  replicas: 2
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      securityContext:
        runAsNonRoot: true
        runAsUser: 65532
        runAsGroup: 65532
        seccompProfile:
          type: RuntimeDefault
      containers:
        - name: web
          image: gcr.io/google-samples/hello-app:2.0
          ports:
            - containerPort: 8080
          securityContext:
            allowPrivilegeEscalation: false
            capabilities:
              drop: ["ALL"]
EOF

kubectl expose deployment web --port=80 --target-port=8080
kubectl get pods -l app=web
```

İki pod `Running` olduğunda uygulama küme içinde `web` adıyla erişilebilir durumdadır. Komutu Windows'ta çalıştırıyorsanız YAML bölümünü `web.yaml` adıyla kaydedip `kubectl apply -f web.yaml` yazın.

> **Neden securityContext?:** Kümede pod güvenlik standartları açıktır: ayrıcalıklı container gibi riskli ayarlar engellenir, daha sıkı `restricted` düzeyine uymayan tanımlar için `kubectl` bir uyarı basar. Uyarı bilgi amaçlıdır, pod yine çalışır. Bu örnek root olmadan (`runAsUser: 65532`), ek yetki almadan çalıştığı için uyarı vermez; kendi imajınızda da aynı alanları kullanabilirsiniz. İmajınız root gerektiriyorsa `runAsNonRoot`, `runAsUser` ve `runAsGroup` satırlarını çıkarın, uyarı görünür ama uygulama çalışır.

## 2. Alan adını düğümlere yönlendirin

Alan adınızın DNS yönetiminde (alan adını aldığınız yer ya da DNS sağlayıcınız) A kaydı açın. Değer olarak panelde küme sayfasındaki düğüm IP adreslerini yazın; tek düğümlü kümede tek kayıt yeterlidir.

| Ad | Tür | Değer |
| --- | --- | --- |
| `uygulama` | A | 1. düğümün IP adresi (ör. yönetim düğümü) |
| `uygulama` | A | 2. düğümün IP adresi (ör. bir çalışan düğüm) |

Birden çok düğümünüz varsa her düğümün IP adresini ayrı bir A kaydı olarak ekleyin: bir düğüm yeniden başlarken (ör. sürüm yükseltmesinde) siteniz diğer düğümlerden açılmaya devam eder. İstekler de düğümler arasında dağılır. Bir düğümü çıkardığınızda IP'sini DNS'ten de silin.

Kayıt yayıldı mı?:

```
nslookup uygulama.ornek.com.tr
```

> **Vekil (proxy) kapalı olsun:** DNS sağlayıcınızda kayıt için vekil ya da CDN özelliği açıksa ilk sertifika doğrulaması başarısız olabilir. Sertifika alınana kadar kaydı yalnız DNS olarak bırakın.

## 3. Ingress ile yayınlayın

Ingress tanımında sınıf `web`, sertifika için `otomatik-ssl` kullanılır. Alan adını iki yerde (tls ve rules) aynı yazın.

Terminal:

```
kubectl apply -f - <<'EOF'
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: web
  annotations:
    cert-manager.io/cluster-issuer: otomatik-ssl
spec:
  ingressClassName: web
  tls:
    - hosts: ["uygulama.ornek.com.tr"]
      secretName: web-tls
  rules:
    - host: uygulama.ornek.com.tr
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web
                port:
                  number: 80
EOF
```

Komutu Windows'ta çalıştırıyorsanız YAML bölümünü `ingress.yaml` adıyla kaydedip `kubectl apply -f ingress.yaml` yazın.

## 4. Sertifikayı doğrulayın

Sertifika genellikle bir iki dakikada hazır olur. `READY` sütunu `True` olduğunda adres HTTPS ile açılır.

Terminal:

```
kubectl get certificate web-tls
curl https://uygulama.ornek.com.tr
```

Hazır olmuyorsa ayrıntıya bakın: `kubectl describe certificate web-tls` ve `kubectl get challenges` çıktısı nedeni yazar.

| Belirti | Neden ve çözüm |
| --- | --- |
| Doğrulama bekliyor, ilerlemiyor | DNS kaydı henüz yayılmamış ya da başka bir IP'yi gösteriyor. `nslookup` ile kontrol edin, düzelince kendiliğinden yeniden denenir. |
| 404 ya da varsayılan sayfa | Ingress'teki `host` ile tarayıcıdaki adres aynı değil, ya da `ingressClassName: web` eksik. |
| Çok sayıda başarısız deneme | Ücretsiz sertifika otoritesinin deneme sınırları vardır. Önce DNS'i düzeltin, sonra tekrar deneyin; Ingress'i art arda silip açmayın. |
| Joker (*.ornek.com.tr) sertifika | HTTP doğrulaması joker sertifika vermez; her alt alan adını Ingress'e ayrı yazın. |

## Birden çok alan adı ve uygulama

Aynı Ingress'e birden çok `host` yazabilir ya da her uygulama için ayrı Ingress açabilirsiniz; hepsi aynı 80 ve 443 portlarını paylaşır. Sertifikayı her alan adı için ayrı Secret'ta tutmak, birini kaldırdığınızda diğerlerini etkilemez.

Yönetim panelleri gibi iç araçları internete açmak zorunda değilsiniz: `kubectl port-forward` ile yalnız kendi bilgisayarınızdan erişebilirsiniz.

## Kümeniz yoksa

Giriş denetleyicisi ve otomatik SSL her kümede hazır gelir; ayrı kurulum ya da ücret yoktur.

- Küme yönetimi ücretsiz; yalnız düğüm olarak kullanılan bulut sunucuların fiyatını ödersiniz.
- Giriş denetleyicisi (sınıf `web`), otomatik SSL (`otomatik-ssl`), şifreli düğüm trafiği ve 12 saatte bir küme yedeği kurulumla gelir.
- Tek sunucuyla başlar, büyüdükçe panelden çalışan düğüm eklersiniz.

Hazır yapılar ve canlı fiyat [Kubernetes Kümesi](https://sunucu.com.tr/kubernetes) sayfasında; kümeyi aynı sayfadaki [hesaplayıcıdan](https://sunucu.com.tr/kubernetes#siparis) oluşturursunuz.

## Sık sorulan sorular

### SSL sertifikası ücretli mi?

Hayır. otomatik-ssl ücretsiz bir sertifika otoritesinden alan adı doğrulamalı sertifika alır ve süresi dolmadan kendiliğinden yeniler.

### Kendi satın aldığım sertifikayı kullanabilir miyim?

Evet. Sertifikayı kubectl create secret tls komutuyla bir Secret'a koyun ve Ingress'in tls bölümünde o Secret'ın adını verin; bu durumda otomatik-ssl ek açıklamasını yazmayın.

### Alan adını hangi düğüme yönlendirmeliyim?

Mümkünse birden çok düğüme: giriş denetleyicisi her düğümde çalışır ve isteği uygulamanın podlarına iletir. Her düğüm IP'sini ayrı A kaydı olarak eklerseniz istekler düğümlere dağılır ve bir düğüm yeniden başlarken (ör. sürüm yükseltmesinde) site diğer düğümlerden açılmaya devam eder. Tek IP'ye bakan alan adı o düğüm yeniden başlarken birkaç saniye erişilemez.
