
Apache Kafka, olayları topic’lere yazarak üreticilerle tüketicileri birbirinden ayıran bir veri akışı platformudur. Bir topic’in partition sayısı, anahtar kullanımı ve tüketici grupları sıralama ile paralelliği etkiler. Kafka kullanmak tek başına veri kaybı olmayacağını veya yedek ihtiyacının ortadan kalktığını göstermez.
Bu rehber Ubuntu 24.04 LTS, Java 21 ve Kafka 4.1.2 ile aynı makinede çalışan tek düğümlü bir KRaft laboratuvarı kurar. Kafka 4.x ZooKeeper kullanmaz. Örnek yalnız loopback adreslerine bağlanır; üretim kümesi, uzaktan erişim, TLS/SASL veya yüksek erişilebilirlik kurulumu değildir.

Görselin adım adım açıklaması
- Yaz: Üretici kaydı bir topic bölümüne gönderir.
- Sırala: Sıra garantisi bölüm içindedir.
- Paylaş: Grup içindeki bölüm atamalarını dağıt.
- İlerle: Offset ile bölümdeki konumu takip et.
1. Java ve ayrı çalışma dizinini hazırlayın
Sudo hesabı paket kurulumu için, normal kullanıcı ise Kafka işlemi için kullanılır. Mevcut Kafka veri dizinine veya üretim portlarına dokunmayın.
sudo apt update
sudo apt install openjdk-21-jre-headless curl python3
java -version
mkdir -p "$HOME/fc-kafka-lab"
chmod 0700 "$HOME/fc-kafka-lab"
cd "$HOME/fc-kafka-lab" Kafka 4.1 dokümanları sunucu için Java 17 ve 21 desteğini açıklar; bu örnek Java 21 seçer. Java 11 istemci kitaplıklarıyla ilgili bir ifade, aynı sürümün Kafka sunucusu için uygun olduğu anlamına gelmez. JVM, disk ve işletim sistemi için yeterli kaynak bırakın.
2. Sürümlü arşivi ve checksum’u doğrulayın
curl --fail --location --proto '=https' https://downloads.apache.org/kafka/4.1.2/kafka_2.13-4.1.2.tgz -o kafka_2.13-4.1.2.tgz
curl --fail --location --proto '=https' https://downloads.apache.org/kafka/4.1.2/kafka_2.13-4.1.2.tgz.sha512 -o kafka_2.13-4.1.2.tgz.sha512
python3 - <<'PY'
import hashlib
import pathlib
import re
archive = pathlib.Path('kafka_2.13-4.1.2.tgz')
checksum = pathlib.Path('kafka_2.13-4.1.2.tgz.sha512').read_text()
expected = re.sub(r'\s+', '', checksum.split(':', 1)[1]).lower()
digest = hashlib.sha512()
with archive.open('rb') as stream:
for chunk in iter(lambda: stream.read(1024 * 1024), b''):
digest.update(chunk)
if len(expected) != 128 or digest.hexdigest() != expected:
raise SystemExit('SHA-512 mismatch; do not extract or run')
print('SHA-512 OK')
PY Apache’nin checksum dosyası bu sürümde dosya adı ve gruplu hash içerdiği için bu biçime uygun karşılaştırma yapıyoruz. Başarısız kontrolün ardından devam etmeyin. Aynı resmî kaynaktaki checksum aktarım tutarlılığını doğrular; daha güçlü yayıncı doğrulaması için Apache’nin imza/KEYS yönergesini izleyin. Sürüm indirme dizininden taşınırsa resmî indirme ve arşiv sayfasından doğru kaynağı bulun; rastgele bir aynaya geçmeyin.
tar --no-same-owner -xzf kafka_2.13-4.1.2.tgz
cd kafka_2.13-4.1.2
bin/kafka-topics.sh --version 3. Yalnız yerel bağlantıya açık KRaft yapılandırması oluşturun
19092 ve 19093 portlarının kullanılmadığını kontrol edin. Dizin yolu boşluk içermeyen ayrı bir laboratuvar alanı olmalıdır.
ss -ltn '( sport = :19092 or sport = :19093 )'
cat > config/fc-local.properties <<EOF
process.roles=broker,controller
node.id=1
controller.quorum.bootstrap.servers=127.0.0.1:19093
listeners=PLAINTEXT://127.0.0.1:19092,CONTROLLER://127.0.0.1:19093
advertised.listeners=PLAINTEXT://127.0.0.1:19092
listener.security.protocol.map=CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT
controller.listener.names=CONTROLLER
inter.broker.listener.name=PLAINTEXT
log.dirs=$PWD/data
num.partitions=1
offsets.topic.replication.factor=1
offsets.topic.num.partitions=1
transaction.state.log.replication.factor=1
transaction.state.log.min.isr=1
EOF listeners bağlanılan adresi, advertised.listeners istemcilere bildirilen adresi belirler. İkisinin de loopback olması önemlidir. PLAINTEXT şifreleme ve kullanıcı doğrulaması sağlamaz; bu örneği 0.0.0.0 yapıp internete açmayın.
Yeni ve boş laboratuvar için yalnız bir kez cluster kimliği üretip depoyu biçimlendirin:
FC_KAFKA_CLUSTER_ID="$(bin/kafka-storage.sh random-uuid)"
bin/kafka-storage.sh format --standalone -t "$FC_KAFKA_CLUSTER_ID" -c config/fc-local.properties Mevcut veri veya meta.properties varsa bu başlangıç adımını tekrar çalıştırmayın. Yeniden başlatmak için yeni cluster ID üretmek veya veri dizinini silmek gerekmez. --ignore-formatted ile hatayı zorla aşmayın.
4. Sunucuyu başlatın ve topic oluşturun
İlk terminalde foreground olarak çalıştırın:
KAFKA_HEAP_OPTS='-Xms256m -Xmx256m' bin/kafka-server-start.sh config/fc-local.properties Bu küçük heap yalnız düşük hacimli laboratuvar içindir; üretim boyutlandırma önerisi değildir. Terminali açık bırakın. Başka bir terminalde aynı Kafka dizinine geçip:
bin/kafka-topics.sh --bootstrap-server 127.0.0.1:19092 --create --topic fc-events --partitions 1 --replication-factor 1
bin/kafka-topics.sh --bootstrap-server 127.0.0.1:19092 --describe --topic fc-events Topic zaten varsa önce içeriğini ve sahipliğini inceleyin; silip yeniden oluşturarak devam etmeyin. Çıktıda bir partition, bir replica ve atanmış lider görünmelidir. Tek replica, düğüm arızasına karşı kopya koruması sağlamaz.
5. Olay yazın ve okuyun
printf 'order-created:1001\norder-created:1002\n' | bin/kafka-console-producer.sh --bootstrap-server 127.0.0.1:19092 --topic fc-events --producer-property acks=all
bin/kafka-console-consumer.sh --bootstrap-server 127.0.0.1:19092 --topic fc-events --from-beginning --max-messages 2 --timeout-ms 30000 İki olayın sırayla okunmasını bekleyin. Yer tutucu olarak <topic adı> gibi shell’in yönlendirme işareti kabul edeceği ifadeler kullanmıyoruz. Bu örnek tek partition olduğu için sıralama kolaydır; farklı partition’lar arasında tek bir küresel sıra garanti edilmez.
acks=all, uygun replica/ISR yapılandırmasıyla birlikte değerlendirilir. Bu tek düğümlü örnekte başka kopya olmadığı için diskin veya düğümün kaybına karşı yüksek erişilebilirlik sağlamaz. Tüketici grubu kullanıldığında commit edilen offset’ler yeniden okuma davranışını değiştirir; --from-beginning her durumda kayıtlı offset’i geçersiz kılmaz.
6. Yeniden başlatma ve erişim kabulü
Sunucu terminalinde Ctrl+C ile düzgün kapatın. Aynı konfigürasyon ve veri diziniyle yeniden başlatın; depoyu yeniden formatlamayın. Topic’i describe edip tüketici komutuyla iki kaydın hâlâ bulunduğunu doğrulayın.
ss -ltn çıktısında 19092/19093 dinleyicileri yalnız 127.0.0.1 olmalıdır. Başka makineden genel IP üzerindeki bu portlara erişim başarılı olmamalıdır. Günlükte beklenmeyen hata, disk doluluğu veya sürekli lider seçimi olmadığını kontrol edin.
Sorun giderme ve üretime geçiş
- Bağlantı kurulamadı: JVM ve port dinleyicisini, ardından listener/advertised listener değerlerini kontrol edin.
- Unsupported class version: sunucunun gerçekten Java 21 ile çalıştığını doğrulayın; sadece kurulu paket adına bakmayın.
- Topic zaten var: doğru topic’i describe edin; var olan veriyi otomatik silmeyin.
- Consumer zaman aşımı: topic adı, yazılan olaylar, grup offset’i ve broker günlüklerini inceleyin.
- Bellek veya disk sorunu: kaynakları ölçün; retention, disk kapasitesi ve trafik hacmini birlikte planlayın.
Üretimde ayrı controller/broker topolojisi, replica sayısı, minimum ISR, producer onayları, retention, TLS/SASL, ACL, izleme ve geri dönüş planı tasarlanmalıdır. Bir replica sayısı seçmek tek başına veri kaybını önleme taahhüdü değildir. Yedek/geri yükleme ve felaket kurtarma kabulünü gerçek iş yükünüzle yapın. FibaCloud üzerinde çalıştıracağınız Kafka’nın yönetilen bir hizmet olup olmadığı satın aldığınız ürün kapsamıyla belirlenir; bu rehber otomatik yönetilen Kafka entegrasyonu vaadi içermez.
Laboratuvarı bitirdiğinizde önce Kafka’yı düzgün kapatın. Yalnız size ait test dizinini arşivleyin veya bilinçli olarak temizleyin; üretim veri dizinleri için toplu silme komutları kullanmayın. Java/Kafka çalışma, restart ve ağ kabulü ayrı test ortamında tamamlanmadan kendi sunucunuzu doğrulanmış saymayın.
Resmî kaynaklar
- Kafka 4.1 hızlı başlangıç ve KRaft akışı
- Kafka 4.1 Java sürüm desteği
- Kafka listener ve güvenlik kapsamı
- Apache Kafka indirmeleri
Teknik içerik ve kaynaklar 4 Ekim 2026 tarihinde gözden geçirildi. Sürüm veya sağlayıcı değişikliğinde ilgili resmî belgeyi yeniden kontrol edin.
Bir yanıt yazın