Merhaba arkadaşlar, bugün sizlere Docker ortamınızı bir web arayüzü üzerinden görsel olarak yönetmenizi sağlayacak harika bir araç olan Portainer'ı, Docker Compose kullanarak nasıl kuracağınızı anlatacağım. Terminalde komut yazmaktan sıkılanlar veya birden fazla sunucudaki konteynerleri tek bir yerden yönetmek isteyenler için bu rehber tam size göre. Portainer sayesinde konteynerleri başlatıp durdurabilir, logları inceleyebilir, image'ları yönetebilir ve ağ ayarlarınızı kolayca düzenleyebilirsiniz.
Portainer Nedir ve Neden Kullanmalıyız?
Portainer, Docker ve Kubernetes ortamları için hafif ve kullanıcı dostu bir yönetim panelidir. Özellikle birden fazla Docker host'unuz varsa veya Docker komutlarını ezberlemek istemiyorsanız işinizi inanılmaz kolaylaştırır. Benim sunucu parkurumda olmazsa olmaz araçlardan biridir. Kurulumu da oldukça basittir.
Docker Compose Dosyasını Hazırlayalım
Öncelikle, Portainer'ı çalıştıracağımız dizinde bir `docker-compose.yml` dosyası oluşturacağız. Ben genelde /opt/portainer gibi bir dizin oluşturup işlemleri oradan yürütmeyi tercih ediyorum. Siz de kendi yapınıza uygun bir yol belirleyebilirsiniz.
Aşağıdaki komutla önce dizinimizi oluşturup içine girelim:
Şimdi, favori metin düzenleyicinizle (nano, vim) `docker-compose.yml` dosyasını oluşturalım:
Dosyanın içine aşağıdaki konfigürasyonu yapıştırın. Bu yapılandırma, Portainer'ın verilerini kalıcı hale getirmek için bir volume, 8000 ve 9443 portlarını kullanmak için port yönlendirmeleri içeriyor. 9443 portu güvenli (HTTPS) yönetim arayüzü içindir.
Dosyayı kaydedip çıktıktan sonra (nano için `Ctrl+X`, `Y`, `Enter`), kuruluma geçebiliriz.
Güvenlik Notu ve Dikkat Edilmesi Gerekenler
Burada çok önemli bir noktaya değinmek istiyorum. Docker socket'ini (/var/run/docker.sock) konteyner içine bağlamak, o konteynere Docker host üzerinde root yetkileri verir. Bu nedenle Portainer konteynerinin güvenliğine ve erişimine çok dikkat etmelisiniz. Yalnızca güvenilir ağlardan erişime açın ve 9443 portu üzerinden güçlü bir parola ile HTTPS erişimini kullanın. Mümkünse bir reverse proxy (Nginx, Traefik) arkasına alıp ek güvenlik önlemleri ekleyin.
Konteyneri Çalıştırma ve İlk Kurulum
Docker Compose dosyamız hazır. Şimdi sıra konteyneri ayağa kaldırmakta. Aşağıdaki komutu çalıştıralım:
Komut çalıştıktan sonra `sudo docker-compose ps` yazarak konteynerin durumunu kontrol edebilirsiniz. "Up" durumunu görmelisiniz.
Artık tarayıcınızdan, sunucunuzun IP adresini ve `9443` portunu kullanarak Portainer arayüzüne erişebilirsiniz. Örneğin:
İlk girişte sizden bir yönetici kullanıcı adı ve güçlü bir parola oluşturmanız istenecek. Bu bilgileri güvenli bir yere kaydedin.
Portainer'ı Yapılandırma
İlk girişi yaptıktan sonra karşınıza "Get Started" ekranı gelecek. Burada "Connect" seçeneği ile mevcut Docker ortamınıza (local environment) bağlanabilirsiniz. Portainer, /var/run/docker.sock üzerinden otomatik olarak host'unuzdaki Docker'ı görecektir. "Local" ortamı seçip "Connect" butonuna tıklayın.
Artık ana paneldensiniz! Sol taraftaki menüden "Containers", "Images", "Volumes", "Networks" gibi tüm Docker bileşenlerini görsel olarak listeleyebilir, yeni konteynerler oluşturabilir veya mevcutları düzenleyebilirsiniz.
İpuçları ve Optimizasyon
Güncellemeler: Portainer imajını güncellemek istediğinizde, dizine (`/opt/portainer`) gidip `sudo docker-compose pull` ve ardından `sudo docker-compose up -d --force-recreate` komutlarını çalıştırabilirsiniz.
Yedekleme: portainer_data volume'ünüzü düzenli olarak yedeklemeyi unutmayın. Bu volume tüm Portainer ayarlarınızı ve yapılandırmalarınızı içerir.
Reverse Proxy: Yukarıda da belirttiğim gibi, Nginx veya Traefik gibi bir reverse proxy kullanarak 9443 portunu dışarı açmak yerine, kendi domaininiz ve SSL sertifikanız üzerinden erişimi sağlamak çok daha güvenli ve profesyonel bir yöntemdir.
Umarım bu rehber, Docker dünyasını yönetmek için işinizi kolaylaştırır. Portainer, özellikle yeni başlayanlar ve görsel arayüz sevenler için gerçek bir hayat kurtarıcı. Siz bu konfigürasyonu kendi sunucularınızda nasıl yapıyorsunuz? Eklemek istediğiniz ipuçlarınız veya takıldığınız bir nokta varsa aşağıya yazmaktan çekinmeyin. Herkese sorunsuz konteynerler!
Portainer Nedir ve Neden Kullanmalıyız?Portainer, Docker ve Kubernetes ortamları için hafif ve kullanıcı dostu bir yönetim panelidir. Özellikle birden fazla Docker host'unuz varsa veya Docker komutlarını ezberlemek istemiyorsanız işinizi inanılmaz kolaylaştırır. Benim sunucu parkurumda olmazsa olmaz araçlardan biridir. Kurulumu da oldukça basittir.
Docker Compose Dosyasını HazırlayalımÖncelikle, Portainer'ı çalıştıracağımız dizinde bir `docker-compose.yml` dosyası oluşturacağız. Ben genelde /opt/portainer gibi bir dizin oluşturup işlemleri oradan yürütmeyi tercih ediyorum. Siz de kendi yapınıza uygun bir yol belirleyebilirsiniz.
Aşağıdaki komutla önce dizinimizi oluşturup içine girelim:
Bash:
sudo mkdir -p /opt/portainer
cd /opt/portainerŞimdi, favori metin düzenleyicinizle (nano, vim) `docker-compose.yml` dosyasını oluşturalım:
Bash:
sudo nano docker-compose.ymlDosyanın içine aşağıdaki konfigürasyonu yapıştırın. Bu yapılandırma, Portainer'ın verilerini kalıcı hale getirmek için bir volume, 8000 ve 9443 portlarını kullanmak için port yönlendirmeleri içeriyor. 9443 portu güvenli (HTTPS) yönetim arayüzü içindir.
YAML:
version: '3.8'
services:
portainer:
image: portainer/portainer-ce:latest
container_name: portainer
restart: unless-stopped
security_opt:
- no-new-privileges:true
volumes:
- /etc/localtime:/etc/localtime:ro
- /var/run/docker.sock:/var/run/docker.sock:ro
- portainer_data:/data
ports:
- "8000:8000"
- "9443:9443"
volumes:
portainer_data:Dosyayı kaydedip çıktıktan sonra (nano için `Ctrl+X`, `Y`, `Enter`), kuruluma geçebiliriz.
Güvenlik Notu ve Dikkat Edilmesi GerekenlerBurada çok önemli bir noktaya değinmek istiyorum. Docker socket'ini (/var/run/docker.sock) konteyner içine bağlamak, o konteynere Docker host üzerinde root yetkileri verir. Bu nedenle Portainer konteynerinin güvenliğine ve erişimine çok dikkat etmelisiniz. Yalnızca güvenilir ağlardan erişime açın ve 9443 portu üzerinden güçlü bir parola ile HTTPS erişimini kullanın. Mümkünse bir reverse proxy (Nginx, Traefik) arkasına alıp ek güvenlik önlemleri ekleyin.
Konteyneri Çalıştırma ve İlk KurulumDocker Compose dosyamız hazır. Şimdi sıra konteyneri ayağa kaldırmakta. Aşağıdaki komutu çalıştıralım:
Bash:
sudo docker-compose up -dKomut çalıştıktan sonra `sudo docker-compose ps` yazarak konteynerin durumunu kontrol edebilirsiniz. "Up" durumunu görmelisiniz.
Artık tarayıcınızdan, sunucunuzun IP adresini ve `9443` portunu kullanarak Portainer arayüzüne erişebilirsiniz. Örneğin:
Bu bağlantı ziyaretçiler için gizlenmiştir. Görmek için lütfen giriş yapın veya üye olun.
İlk girişte sizden bir yönetici kullanıcı adı ve güçlü bir parola oluşturmanız istenecek. Bu bilgileri güvenli bir yere kaydedin.
Portainer'ı Yapılandırmaİlk girişi yaptıktan sonra karşınıza "Get Started" ekranı gelecek. Burada "Connect" seçeneği ile mevcut Docker ortamınıza (local environment) bağlanabilirsiniz. Portainer, /var/run/docker.sock üzerinden otomatik olarak host'unuzdaki Docker'ı görecektir. "Local" ortamı seçip "Connect" butonuna tıklayın.
Artık ana paneldensiniz! Sol taraftaki menüden "Containers", "Images", "Volumes", "Networks" gibi tüm Docker bileşenlerini görsel olarak listeleyebilir, yeni konteynerler oluşturabilir veya mevcutları düzenleyebilirsiniz.
İpuçları ve OptimizasyonGüncellemeler: Portainer imajını güncellemek istediğinizde, dizine (`/opt/portainer`) gidip `sudo docker-compose pull` ve ardından `sudo docker-compose up -d --force-recreate` komutlarını çalıştırabilirsiniz.
Yedekleme: portainer_data volume'ünüzü düzenli olarak yedeklemeyi unutmayın. Bu volume tüm Portainer ayarlarınızı ve yapılandırmalarınızı içerir.
Reverse Proxy: Yukarıda da belirttiğim gibi, Nginx veya Traefik gibi bir reverse proxy kullanarak 9443 portunu dışarı açmak yerine, kendi domaininiz ve SSL sertifikanız üzerinden erişimi sağlamak çok daha güvenli ve profesyonel bir yöntemdir.
Umarım bu rehber, Docker dünyasını yönetmek için işinizi kolaylaştırır. Portainer, özellikle yeni başlayanlar ve görsel arayüz sevenler için gerçek bir hayat kurtarıcı. Siz bu konfigürasyonu kendi sunucularınızda nasıl yapıyorsunuz? Eklemek istediğiniz ipuçlarınız veya takıldığınız bir nokta varsa aşağıya yazmaktan çekinmeyin. Herkese sorunsuz konteynerler!