DigitalOcean API v2’yi Ansible 2.0 ile Ubuntu 14.04 Üzerinde Kullanma

DigitalOcean API v2’yi Ansible 2.0 ile Ubuntu 14.04 Üzerinde Kullanma

Giriş

Günümüzün hızla değişen dijital dünyasında, altyapı yönetimi ve dağıtımı süreçlerini otomatikleştirmek, modern BT operasyonlarının temel bir gerekliliğidir. Manuel yapılandırmalar zaman alıcı, hataya açık ve ölçeklendirilmesi zor süreçlerdir. Bu noktada, “Altyapı Kod Olarak” (Infrastructure as Code – IaC) yaklaşımı devreye girer. IaC, altyapınızı yazılım kodu gibi tanımlamanıza, sürüm kontrolünde tutmanıza ve otomatik olarak dağıtmanıza olanak tanır.

Bu makalede, popüler bir bulut sağlayıcısı olan DigitalOcean’ın güçlü API v2’sini, otomasyon aracı Ansible 2.0 ile entegre ederek, altyapı yönetimini nasıl otomatikleştirebileceğimizi ayrıntılı olarak inceleyeceğiz. Kontrol makinesi olarak Ubuntu 14.04 işletim sistemini kullanacağız. Ubuntu 14.04, nispeten eski bir sürüm olsa da, hala belirli kurumsal veya miras sistemlerde kullanılmakta olup, temel prensipleri anlamak için mükemmel bir başlangıç noktası sunar. DigitalOcean API v2, Droplet’lerden (sanal sunucular), depolama birimlerine, ağ yapılandırmalarına ve veritabanlarına kadar tüm DigitalOcean kaynaklarını programatik olarak yönetmenizi sağlar. Ansible ise, basit ve okunabilir YAML tabanlı playbook’ları aracılığıyla bu API’yi kullanarak altyapınızı tanımlamanıza ve yönetmenize olanak tanır.

Bu makalenin amacı, DigitalOcean API v2’yi Ansible 2.0 ile entegre etmenin adımlarını, ön gereksinimleri, yapılandırma örneklerini ve sık karşılaşılan sorunları kapsamlı bir şekilde açıklamaktır. Böylece, okuyucular kendi otomatik altyapı dağıtım süreçlerini tasarlayabilir ve uygulayabilirler.

Ön Gereksinimler

Bu rehberi takip edebilmek için aşağıdaki ön gereksinimlere sahip olmanız gerekmektedir:

* Ubuntu 14.04 Kurulu Bir Sistem: Ansible kontrol makinesi olarak kullanılacak olan bir Ubuntu 14.04 sunucusu veya sanal makinesi. Bu makalede tüm kurulum ve yapılandırma adımları bu işletim sistemi üzerinde gösterilecektir.
* Temel Linux Bilgisi: Komut satırı kullanımı, paket yönetimi (apt-get), dosya sistemi navigasyonu gibi temel Linux komutlarına aşinalık.
* DigitalOcean Hesabı: Aktif bir DigitalOcean hesabına sahip olmanız gerekmektedir. Eğer yoksa, kolayca bir hesap oluşturabilirsiniz.
* DigitalOcean API Token’ı: DigitalOcean hesabınızda API erişimi için bir kişisel erişim token’ı (Personal Access Token) oluşturmuş olmanız gerekmektedir. Bu token, Ansible’ın DigitalOcean kaynaklarınıza erişimini sağlayacaktır. Token’ın hem okuma hem de yazma (Read & Write) izinlerine sahip olması önemlidir.
* Temel Ansible Bilgisi: Ansible’ın temel kavramlarına (playbook, görevler, modüller, envanter vb.) aşina olmak, bu makaledeki örnekleri daha iyi anlamanıza yardımcı olacaktır.

1. Ubuntu 14.04 Ortamını Hazırlama

Ansible’ı kurmadan ve DigitalOcean API ile etkileşime geçmeden önce, Ubuntu 14.04 kontrol makinemizi hazırlamamız gerekmektedir.

Sistem Güncelleme

Herhangi bir yazılım kurulumuna başlamadan önce sistem paket listesini güncellemek ve mevcut paketleri yükseltmek iyi bir uygulamadır. Bu, potansiyel bağımlılık sorunlarını önlemeye yardımcı olur.

sudo apt-get update
sudo apt-get upgrade -y

Bu komutlar, sistemdeki paket depolarını günceller ve mevcut tüm paketleri en son sürümlerine yükseltir.

Python ve PIP Kurulumu

Ansible, Python ile yazılmıştır ve çalışması için Python’a ihtiyaç duyar. Ayrıca, Ansible’ın DigitalOcean modüllerinin bazı bağımlılıkları için Python paket yöneticisi pip‘e ihtiyacımız olacaktır. Ubuntu 14.04’te Python genellikle ön yüklü gelir, ancak pip‘i ve bazı temel Python geliştirme araçlarını kurmamız gerekebilir.

sudo apt-get install python-minimal python-pip python-dev -y

python-minimal temel Python çalıştırma ortamını sağlar, python-pip Python paket yöneticisidir ve python-dev ise bazı Python modüllerinin derlenmesi için gerekli olan geliştirme dosyalarını içerir. pip‘i en son sürüme güncellemek de önerilir:

sudo pip install --upgrade pip

Ansible Kurulumu

Ubuntu 14.04 için Ansible 2.0’ı kurmanın en güvenilir yolu, Ansible’ın kendi PPA (Personal Package Archive) deposunu kullanmaktır. Bu sayede, daha güncel bir Ansible sürümüne erişebiliriz.

Öncelikle PPA deposunu eklemek için software-properties-common paketini kurmamız gerekebilir:

sudo apt-get install software-properties-common -y

Ardından Ansible PPA’sını ekleyin:

sudo apt-add-repository ppa:ansible/ansible -y

Depoyu ekledikten sonra, paket listesini tekrar güncellemeniz gerekmektedir:

sudo apt-get update

Şimdi Ansible’ı kurabiliriz:

sudo apt-get install ansible -y

Kurulumun başarılı olduğunu ve doğru Ansible sürümünü kurduğunuzu doğrulamak için sürüm kontrolü yapabilirsiniz:

ansible --version

Çıktıda ansible 2.0.x.x gibi bir sürüm numarası görmelisiniz.

2. DigitalOcean API v2 Erişimi İçin Hazırlıklar

Ansible’ın DigitalOcean API ile iletişim kurabilmesi için bazı özel ayarlamalar yapmamız gerekmektedir.

DigitalOcean API Token Oluşturma

DigitalOcean API v2’ye programatik erişim sağlamanın anahtarı bir kişisel erişim token’ıdır. Bu token, hesabınızdaki kaynakları oluşturma, değiştirme veya silme yetkisine sahiptir, bu yüzden güvenli bir şekilde saklanmalıdır.

1. DigitalOcean Kontrol Paneline Giriş Yapın: Tarayıcınızdan DigitalOcean hesabınıza giriş yapın.
2. API Bölümüne Gidin: Sol menüden “API” seçeneğine tıklayın.
3. Yeni Token Oluşturun: “Generate New Token” düğmesine tıklayın.
4. Token Adı ve İzinleri: Token’ınıza anlamlı bir isim verin (örneğin, “ansible-integration”). “Write” (Yazma) kutucuğunun işaretli olduğundan emin olun, çünkü Ansible kaynakları oluşturmak ve değiştirmek için bu izne ihtiyaç duyacaktır. “Read” (Okuma) izni otomatik olarak seçilecektir.
5. Token’ı Kopyalayın: Token oluşturulduktan sonra ekranda beliren token dizesini kopyalayın. Bu token’ı bir daha göremeyeceksiniz, bu yüzden kopyaladığınızdan ve güvenli bir yere (örneğin, bir parola yöneticisi) kaydettiğinizden emin olun. Bu token, Ansible playbook’larınızda kullanılacaktır.

Python requests Kütüphanesi Kurulumu

Ansible’ın DigitalOcean modülleri, DigitalOcean API ile HTTP istekleri aracılığıyla iletişim kurar. Bu iletişim için genellikle Python’ın requests kütüphanesini kullanır. Bu kütüphaneyi kontrol makinesine kurmak, sorunsuz bir çalışma için gereklidir.

sudo pip install requests

Bu komut, Ansible’ın DigitalOcean modüllerinin API çağrılarını yapabilmesi için gerekli olan requests kütüphanesini kurar.

3. Ansible ile DigitalOcean API v2 Kullanımı

Şimdi, Ansible’ı DigitalOcean API ile entegre etmenin pratik adımlarına geçebiliriz.

Ansible Yapılandırması ve Kimlik Doğrulama

API token’ınızı playbook’larınızda doğrudan düz metin olarak saklamak güvenlik açısından son derece risklidir. Ansible, hassas verileri şifrelemek için Ansible Vault adında bir özellik sunar. Bu, API token’ınızı güvenli bir şekilde saklamanın önerilen yoludur.

1. Vault Dosyası Oluşturma:
Öncelikle, API token’ınızı içerecek şifreli bir dosya oluşturalım. Proje dizininizde vars adında bir klasör oluşturun ve içine digitalocean_vars.yml adında bir dosya yaratın:

mkdir -p vars
    ansible-vault create vars/digitalocean_vars.yml

Bu komutu çalıştırdığınızda, sizden bir parola belirlemeniz istenecektir. Bu parola, vault dosyasını şifrelemek ve şifresini çözmek için kullanılacaktır. Parolayı güvenli bir yerde saklayın.

Dosya açıldığında (bir metin editöründe), içine API token’ınızı aşağıdaki gibi ekleyin:

do_api_token: "sizin_digitalocean_api_tokeniniz"

Dosyayı kaydedip kapatın. Artık API token’ınız şifreli bir şekilde saklanmaktadır.

2. Playbook’ta Vault Dosyasını Kullanma:
Playbook’larınızda bu şifreli değişkenleri kullanmak için vars_files anahtarını kullanmanız gerekmektedir.

İlk Playbook: Droplet Oluşturma

DigitalOcean’da bir sanal sunucuya “Droplet” denir. Ansible’ın digital_ocean_droplet modülü, Droplet’leri oluşturmak, güncellemek ve silmek için kullanılır.

Aşağıdaki örnek, ansible-test-droplet adında, nyc3 bölgesinde, s-1vcpu-1gb boyutunda ve Ubuntu 18.04 işletim sistemi imajına sahip bir Droplet oluşturur. Ubuntu 14.04 kontrol makinesinde olsak da, oluşturacağımız Droplet için daha güncel bir imaj kullanmak iyi bir uygulamadır.

create_droplet.yml adında bir dosya oluşturalım:

---
- name: DigitalOcean Droplet Oluşturma
  hosts: localhost
  connection: local
  gather_facts: no # Bu playbook sadece yerel makinede çalışacağı için facts toplamaya gerek yok
  vars_files:
    - vars/digitalocean_vars.yml # Vault ile şifrelenmiş API token'ı içeren dosya

  tasks:
    - name: Yeni bir Droplet oluştur
      digital_ocean_droplet:
        state: present             # Droplet'in var olmasını sağlar (oluşturur)
        api_token: "{{ do_api_token }}" # Vault'tan alınan API token'ı
        name: "ansible-test-droplet" # Droplet'in adı
        size: "s-1vcpu-1gb"        # Droplet boyutu (en küçük)
        region: "nyc3"             # Bölge
        image: "ubuntu-18-04-x64"  # Kullanılacak işletim sistemi imajı
        ssh_keys:                  # Opsiyonel: Droplet'e eklenecek SSH anahtarlarının ID'leri veya parmak izleri
          - "buraya_ssh_anahtar_id_nizi_veya_parmak_izinizi_girin"
        wait: yes                  # Droplet oluşturulana kadar bekle
        count: 1                   # Bir adet Droplet oluştur
      register: new_droplet        # Oluşturulan Droplet bilgilerini değişkene kaydet

    - name: Oluşturulan Droplet bilgilerini göster
      debug:
        var: new_droplet           # Değişkenin içeriğini ekrana yazdır

Önemli: ssh_keys alanına kendi DigitalOcean hesabınıza eklediğiniz bir SSH anahtarının ID’sini veya parmak izini girmeniz gerekmektedir. Eğer SSH anahtarınız yoksa, DigitalOcean panelinden ekleyebilir veya bu satırı şimdilik kaldırabilirsiniz, ancak Droplet’e bağlanmak için root şifresiyle giriş yapmanız gerekir ki bu önerilmez.

Playbook’u çalıştırmak için:

ansible-playbook create_droplet.yml --ask-vault-pass

Bu komut, sizden vault dosyasını şifrelerken kullandığınız parolayı isteyecektir. Doğru parolayı girdikten sonra Ansible, Droplet oluşturma işlemini başlatacaktır. Başarılı bir çalıştırmadan sonra, new_droplet değişkeninin içeriği debug görevi ile ekrana yazdırılacak ve Droplet’in IP adresi, durumu gibi bilgiler görünecektir.

Droplet’e Bağlanma ve İlk Konfigürasyon

Bir Droplet oluşturulduktan sonra, Ansible’ı kullanarak ona bağlanabilir ve ilk konfigürasyonunu yapabiliriz. Bunun için, oluşturulan Droplet’in IP adresini dinamik olarak Ansible envanterine eklememiz gerekir.

Aşağıdaki playbook, yukarıdaki Droplet oluşturma görevini tekrarlar (veya mevcut Droplet’i kontrol eder) ve ardından oluşturulan Droplet’in IP adresini geçici bir envanter grubuna ekleyerek ona ping atar ve apt önbelleğini günceller.

configure_droplet.yml adında yeni bir dosya oluşturalım:

---
- name: Yeni Droplet'e bağlan ve konfigürasyon yap
  hosts: localhost
  connection: local
  gather_facts: no
  vars_files:
    - vars/digitalocean_vars.yml

  tasks:
    - name: Yeni bir Droplet oluştur veya mevcut olanı kontrol et
      digital_ocean_droplet:
        state: present
        api_token: "{{ do_api_token }}"
        name: "ansible-test-droplet"
        size: "s-1vcpu-1gb"
        region: "nyc3"
        image: "ubuntu-18-04-x64"
        ssh_keys:
          - "buraya_ssh_anahtar_id_nizi_veya_parmak_izinizi_girin"
        wait: yes
      register: new_droplet_info

    - name: Yeni Droplet'i geçici envantere ekle
      add_host:
        hostname: "{{ new_droplet_info.droplet.ipv4_address }}"
        groupname: new_droplets
        ansible_user: root # Droplet'e bağlanmak için root kullanıcısı
        ansible_ssh_private_key_file: "~/.ssh/id_rsa" # Kontrol makinesindeki özel SSH anahtarınızın yolu
      when: new_droplet_info.changed # Sadece Droplet yeni oluşturulduysa veya değiştiyse ekle

- name: Yeni Droplet'te ilk konfigürasyon
  hosts: new_droplets # Dinamik olarak eklenen Droplet'leri hedefle
  gather_facts: yes
  become: yes # Görevleri sudo ile çalıştır
  tasks:
    - name: Droplet'e ping atarak bağlantıyı test et
      ping:

    - name: Apt cache'i güncelle
      apt:
        update_cache: yes
        cache_valid_time: 3600 # Önbelleği 1 saat geçerli tut

Önemli: ansible_ssh_private_key_file alanına, SSH anahtarınızın kontrol makinesindeki tam yolunu girmelisiniz (örneğin, ~/.ssh/id_rsa). Bu özel anahtar, Ansible’ın oluşturulan Droplet’e SSH ile bağlanmasını sağlayacaktır.

Playbook’u çalıştırmak için:

ansible-playbook configure_droplet.yml --ask-vault-pass

Bu playbook, Droplet’i oluşturacak (veya zaten varsa bilgileri alacak), IP adresini alıp geçici new_droplets grubuna ekleyecek ve ardından bu gruba dahil olan Droplet’lerde ping atma ve apt önbelleğini güncelleme görevlerini çalıştıracaktır.

Droplet Bilgilerini Alma ve Yönetme

Mevcut Droplet’lerin bilgilerini almak için digital_ocean_droplet_facts modülünü kullanabiliriz. Bu modül, bir veya daha fazla Droplet hakkında detaylı bilgileri getirir.

get_droplet_info.yml adında bir dosya oluşturalım:

---
- name: DigitalOcean Droplet Bilgilerini Alma
  hosts: localhost
  connection: local
  gather_facts: no
  vars_files:
    - vars/digitalocean_vars.yml

  tasks:
    - name: Belirli bir Droplet'in bilgilerini al
      digital_ocean_droplet_facts:
        api_token: "{{ do_api_token }}"
        name: "ansible-test-droplet" # Bilgilerini almak istediğiniz Droplet'in adı
      register: droplet_facts

    - name: Droplet bilgilerini göster
      debug:
        var: droplet_facts.droplets[0] # Eğer birden fazla aynı isimde varsa ilkini alır

Playbook’u çalıştırmak için:

ansible-playbook get_droplet_info.yml --ask-vault-pass

Bu, ansible-test-droplet adlı Droplet’in tüm mevcut bilgilerini (IP adresi, durumu, boyutu, bölgesi vb.) ekrana yazdıracaktır.

Droplet’i Silme

Bir Droplet’i silmek için digital_ocean_droplet modülünü state: absent parametresiyle kullanırız.

delete_droplet.yml adında bir dosya oluşturalım:

---
- name: DigitalOcean Droplet Silme
  hosts: localhost
  connection: local
  gather_facts: no
  vars_files:
    - vars/digitalocean_vars.yml

  tasks:
    - name: Belirtilen Droplet'i sil
      digital_ocean_droplet:
        state: absent              # Droplet'in yok olmasını sağlar (siler)
        api_token: "{{ do_api_token }}"
        name: "ansible-test-droplet" # Silinecek Droplet'in adı
        wait: yes                  # Silme işlemi tamamlanana kadar bekle
      register: delete_result

    - name: Silme sonucunu göster
      debug:
        var: delete_result

Playbook’u çalıştırmak için:

ansible-playbook delete_droplet.yml --ask-vault-pass

Bu komut, ansible-test-droplet adlı Droplet’i DigitalOcean hesabınızdan kalıcı olarak silecektir.

4. Diğer DigitalOcean Kaynaklarını Yönetme (Kısa Bakış)

Ansible, Droplet’lerden çok daha fazlasını yönetmek için DigitalOcean modülleri sunar. İşte bazı önemli örnekler:

SSH Anahtarları (digital_ocean_sshkey)

DigitalOcean hesabınıza SSH anahtarları ekleyebilir, silebilir veya listeleyebilirsiniz. Bu, Droplet oluştururken SSH anahtarlarını otomatik olarak eklemenizi sağlar.

- name: Yeni bir SSH anahtarı ekle
  digital_ocean_sshkey:
    state: present
    api_token: "{{ do_api_token }}"
    name: "my-ansible-ssh-key"
    ssh_pub_key: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}" # Genel anahtar dosyanızın içeriği

Firewall Kuralları (digital_ocean_firewall)

Droplet’ler için güvenlik duvarı kuralları oluşturabilir, güncelleyebilir ve silebilirsiniz.

- name: Web sunucusu için yeni bir güvenlik duvarı oluştur
  digital_ocean_firewall:
    state: present
    api_token: "{{ do_api_token }}"
    name: "web-server-firewall"
    inbound_rules:
      - protocol: tcp
        ports: "80"
        sources:
          addresses: ["0.0.0.0/0"]
      - protocol: tcp
        ports: "22"
        sources:
          addresses: ["your_ip_address/32"] # Kendi IP adresinizi buraya girin
    droplet_ids:
      - "{{ new_droplet_info.droplet.id }}" # Oluşturduğunuz Droplet'in ID'si

Load Balancer’lar (digital_ocean_load_balancer)

Uygulamanız için yük dengeleyiciler oluşturabilir ve yönetebilirsiniz.

- name: Yeni bir Load Balancer oluştur
  digital_ocean_load_balancer:
    state: present
    api_token: "{{ do_api_token }}"
    name: "my-web-lb"
    region: "nyc3"
    forwarding_rules:
      - entry_protocol: http
        entry_port: 80
        target_protocol: http
        target_port: 80
    droplet_ids:
      - "{{ droplet1.id }}"
      - "{{ droplet2.id }}"

Blok Depolama (Block Storage) (digital_ocean_block_storage)

Droplet’lerinize ekleyebileceğiniz blok depolama birimleri oluşturabilir ve yönetebilirsiniz.

- name: Yeni bir blok depolama birimi oluştur
  digital_ocean_block_storage:
    state: present
    api_token: "{{ do_api_token }}"
    name: "my-data-volume"
    size_gigabytes: 10 # 10 GB boyutunda
    region: "nyc3"
    droplet_id: "{{ new_droplet_info.droplet.id }}" # Bağlanacağı Droplet ID'si

Bu modüllerin genel kullanım mantığı digital_ocean_droplet ile benzerdir: state: present/absent ile kaynağın varlığını kontrol eder, api_token ile kimlik doğrulaması yapar ve kaynağa özgü parametrelerle yapılandırmayı sağlar.

5. Dinamik Envanter Kullanımı

Ansible’ın en güçlü özelliklerinden biri dinamik envanter yeteneğidir. Statik bir envanter dosyası (hosts veya inventory) yerine, dinamik envanter betikleri, bulut sağlayıcılarından veya diğer veri kaynaklarından mevcut sunucuların listesini ve ilgili meta verilerini otomatik olarak çekerek Ansible’a sunar. DigitalOcean için de bir dinamik envanter betiği bulunmaktadır.

Dinamik envanter betiği, DigitalOcean hesabınızdaki tüm Droplet’leri otomatik olarak tespit eder ve bunları Ansible’ın kullanabileceği bir envanter formatında düzenler. Bu, özellikle çok sayıda Droplet’iniz olduğunda veya altyapınız sık sık değiştiğinde son derece faydalıdır.

Dinamik Envanter Betiğini Kullanma Adımları:

1. Betiği İndirme:
DigitalOcean dinamik envanter betiğini Ansible’ın GitHub deposundan veya doğrudan indirebilirsiniz. Kontrol makinenizde bir dizin oluşturun ve betiği oraya indirin:

mkdir -p ~/ansible-do-inventory
    cd ~/ansible-do-inventory
    wget https://raw.githubusercontent.com/ansible/ansible/stable-2.0/contrib/inventory/digital_ocean.py
    wget https://raw.githubusercontent.com/ansible/ansible/stable-2.0/contrib/inventory/digital_ocean.ini
    chmod +x digital_ocean.py

Burada stable-2.0 dalını kullandık, çünkü makalemiz Ansible 2.0 üzerine odaklanmıştır.

2. Yapılandırma Dosyası (digital_ocean.ini) Oluşturma:
İndirdiğiniz digital_ocean.ini dosyasını düzenlemeniz gerekmektedir. Bu dosya, dinamik envanter betiğinin DigitalOcean API’sine nasıl bağlanacağını belirler. API token’ınızı bu dosyaya ekleyebilirsiniz:

[digital_ocean]
    # DigitalOcean API token. Required.
    # Can also be specified via the DO_API_TOKEN environment variable.
    api_token = sizin_digitalocean_api_tokeniniz

    # Cache for the inventory.
    # Toggle caching and set cache expiration time (in seconds).
    cache = True
    cache_max_age = 300
    cache_path = ~/.ansible/tmp

api_token alanına DigitalOcean API token’ınızı yapıştırın. Ayrıca, token’ı bir ortam değişkeni olarak da ayarlayabilirsiniz (export DO_API_TOKEN="sizin_tokeniniz"), bu durumda .ini dosyasındaki satırı boş bırakabilirsiniz. Ortam değişkeni kullanmak, API token’ını dosyalarda saklamaktan daha güvenli bir yöntem olabilir.

3. Dinamik Envanteri Kullanma:
Artık Ansible’ı bu dinamik envanter betiğiyle çalıştırabilirsiniz. Örneğin, tüm DigitalOcean Droplet’lerinize ping atmak için:

ansible -i digital_ocean.py all -m ping --user root --private-key ~/.ssh/id_rsa

Bu komut, digital_ocean.py betiğini kullanarak mevcut tüm Droplet’lerinizi listeler ve her birine ping atmayı dener. ansible_user ve ansible_ssh_private_key_file parametrelerini, Droplet’lerinize SSH ile bağlanmak için doğru kimlik bilgilerini sağlamak üzere ayarlamanız önemlidir.

Dinamik envanter, altyapınızın sürekli değiştiği, Droplet’lerin otomatik olarak ölçeklendiği veya sık sık oluşturulup silindiği senaryolarda vazgeçilmez bir araçtır.

Sık Karşılaşılan Sorunlar ve Çözümleri

DigitalOcean API v2’yi Ansible ile kullanırken karşılaşabileceğiniz bazı yaygın sorunlar ve bunların çözümleri:

* API Token Hataları (Yetkilendirme Sorunları):
* Sorun: Authentication Failed veya Unauthorized gibi hatalar alıyorsunuz.
* Çözüm: API token’ınızın doğru olduğundan, kopyalarken herhangi bir karakterin eksik kalmadığından ve digitalocean_vars.yml dosyasında doğru şekilde tanımlandığından emin olun. Ayrıca, token’ın hem okuma hem de yazma izinlerine sahip olduğundan emin olun. Vault parolasını doğru girdiğinizden de emin olun.
* Modül Eksiklikleri:
* Sorun: No module named requests veya benzeri Python kütüphanesi hataları alıyorsunuz.
* Çözüm: sudo pip install requests komutunu çalıştırarak gerekli Python kütüphanelerini kurduğunuzdan emin olun. Ansible’ın DigitalOcean modülleri genellikle requests kütüphanesine ihtiyaç duyar.
* Ağ Sorunları (Firewall, DNS):
* Sorun: Ansible, DigitalOcean API’sine veya oluşturduğu Droplet’lere bağlanamıyor.
* Çözüm: Kontrol makinenizin internet bağlantısını kontrol edin. DigitalOcean API’sinin erişilebilir olduğundan emin olun (örneğin, curl https://api.digitalocean.com/v2/ komutuyla test edebilirsiniz). Oluşturduğunuz Droplet’e SSH ile manuel olarak bağlanmayı deneyin. Droplet’in güvenlik duvarı kurallarının (varsa) SSH (port 22) trafiğine izin verdiğinden emin olun.
* Idempotence’ın Önemi:
* Sorun: Aynı playbook’u tekrar çalıştırdığınızda beklenmedik sonuçlar veya hatalar alıyorsunuz.
* Çözüm: Ansible modülleri genellikle idempotent olacak şekilde tasarlanmıştır, yani bir görevi birden çok kez çalıştırmak aynı sonucu vermelidir. Eğer bir Droplet zaten varsa state: present onu tekrar oluşturmaya çalışmaz, sadece mevcut olduğunu doğrular. Ancak, bazı özel senaryolarda veya custom betiklerde idempotence’ı sağlamak sizin sorumluluğunuzdadır. Playbook’larınızı idempotent olacak şekilde tasarladığınızdan emin olun.
* Ubuntu 14.04 ve Sürüm Uyumluluğu:
* Sorun: Python veya Ansible’ın belirli modülleri Ubuntu 14.04’teki eski Python sürümleriyle uyumluluk sorunları yaşıyor.
* Çözüm: Bu makalede belirtildiği gibi PPA kullanarak Ansible 2.0’ı kurmak ve pip ile kütüphaneleri güncel tutmak bu tür sorunları minimize etmelidir. Ancak, çok eski bir işletim sistemi kullanırken bazı modern Python kütüphaneleriyle uyumluluk sorunları yaşanması beklenebilir. Gerekirse, bir Python sanal ortamı (virtualenv) kullanmayı düşünebilirsiniz, ancak bu Ubuntu 14.04’ün varsayılan Python’unu etkilemeden bağımlılıkları izole etmenin daha gelişmiş bir yoludur.

Sonuç

Bu makalede, DigitalOcean API v2’yi Ansible 2.0 ile Ubuntu 14.04 kontrol makinesi üzerinde nasıl kullanacağımızı detaylı bir şekilde inceledik. Altyapı kod olarak (IaC) prensiplerini benimseyerek, DigitalOcean Droplet’lerini oluşturma, yapılandırma, bilgilerini alma ve silme gibi temel işlemleri otomatikleştirmeyi öğrendik. Ayrıca, Ansible Vault kullanarak API token’ı gibi hassas bilgileri güvenli bir şekilde saklamanın önemine değindik ve dinamik envanter kullanımının faydalarını gördük.

DigitalOcean’ın zengin API’si ve Ansible’ın esnek otomasyon yetenekleri birleştiğinde, bulut altyapınızı hızlı, tutarlı ve ölçeklenebilir bir şekilde yönetmek için güçlü bir araç seti elde edersiniz. Bu entegrasyon, geliştirme ve üretim ortamlarınızın dağıtımını basitleştirir, insan hatasını azaltır ve operasyonel verimliliği artırır.

Öğrenilen bu bilgilerle, sadece Droplet’lerle sınırlı kalmayıp, DigitalOcean’daki diğer kaynakları (blok depolama, yük dengeleyiciler, güvenlik duvarları, veritabanları vb.) da Ansible modülleri aracılığıyla yönetebilirsiniz. Bu, karmaşık bulut altyapılarını tek bir kod tabanından kontrol etmenize olanak tanır.

İleriye dönük olarak, bu temel bilgileri kullanarak daha karmaşık senaryolar üzerinde çalışabilirsiniz:

* Uçtan Uca Uygulama Dağıtımı: Bir Droplet oluşturmaktan, bir web sunucusu kurmaya, veritabanını yapılandırmaya ve bir uygulamayı dağıtmaya kadar tüm süreci otomatikleştiren playbook’lar yazın.
* Dinamik Ölçeklendirme: Bir izleme sistemi ile entegre olarak, belirli koşullar altında otomatik olarak Droplet ekleyen veya kaldıran Ansible playbook’ları oluşturun.
* Diğer Bulut Sağlayıcıları: Ansible’ın AWS, Azure, Google Cloud gibi diğer bulut sağlayıcıları için de benzer modülleri bulunmaktadır. Öğrendiğiniz prensipleri bu platformlara uygulayarak çoklu bulut stratejileri geliştirebilirsiniz.
* CI/CD Entegrasyonu: Ansible playbook’larınızı Jenkins, GitLab CI/CD veya CircleCI gibi sürekli entegrasyon/sürekli dağıtım (CI/CD) boru hatlarına entegre ederek tamamen otomatik bir dağıtım süreci oluşturun.

Altyapı otomasyonu, modern yazılım geliştirme ve operasyonlarının vazgeçilmez bir parçasıdır. Ansible ve DigitalOcean API v2 gibi araçları ustaca kullanarak, daha verimli, güvenilir ve esnek bir dijital altyapı inşa etme yolunda önemli adımlar atmış olursunuz.