İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Bir Compose projesini içe aktarma — PostgreSQL ve Redis ile bir not API'si

Bir API’yi, bu API’nin notlarını tuttuğu PostgreSQL veritabanını ve bir Redis önbelleğini çalıştıran bir Compose dosyası, aggrega import ile Aggrega dosyalarına taslak olarak aktarılmış — bağlantılar, veritabanının ayarları, değişken referansı olarak parola ve her imajın etiketi aktarılarak — ve Docker Compose için derlenmiş.

Bir Compose projesini içe aktarma bunu adım adım anlatır: komutu, yazdığı dosyaları ve her satırın neden orada olduğunu, derlemeyi ve çalışan yığını. Bu klasör, o adım adım anlatımın her aşamasını içerir:

klasör veya dosyaiçeriği
source/Compose projesi, compose.yaml, klasörü bir çalışma alanı yapan .aggrega-config.yaml ve Kubernetes için bir derlemenin ihtiyaç duyduğu, hiçbir Compose dosyasının içermediği tek değeri tutan import-answers.yaml
draft/aggrega import compose.yaml --target compose komutunun yazdığı dosyalar, değiştirilmemiş haliyle, release.lock dahil, ve komutun yazdırdıkları: standart çıktıya stdout.txt, standart hataya import.txt

Belge deposunun bir checkout’unda check.sh, içe aktarmayı yeniden çalıştırır, yazdıklarını ve yazdırdıklarını draft/ ile karşılaştırır, adım adım anlatımın alıntıladığı blokları bu dosyalarla karşılaştırır ve içe aktarmanın yazdıklarını doğrulayıp derler. Standart kütüphane kataloğunun (nereden edinilir) bu deponun yanında checkout edilmiş olmasına ya da dizininin AGGREGA_CATALOG_DIRS içinde belirtilmesine ihtiyaç duyar.

Örneği oluşturun

Bu örneğin içe aktarmasını aşağıdaki komutlarla çalıştırabilir ya da yapay zekâ asistanınıza sizin yerinize çalıştırtabilirsiniz.

Örneği, adını taşıyan yeni bir klasöre yazın:

Terminal window
aggrega scaffold --example import-compose

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd import-compose

Derleme

İçe aktarma, Aggrega dosyalarını projenin yanına, source/ içine taslak olarak yazar. Projeyi, çalışma alanının varsayılan kayıt defterinin imzalı bir anlık görüntü olarak yayımladığı standart kütüphane kataloğuyla karşılaştırır: ilk içe aktarma onu getirir, doğrular, çalışma alanının içerik önbelleğinde tutar ve taslakların yanına yazdığı kayıtta onu özetiyle (digest) adlandırır. Kendi katalog klasörlerini — AGGREGA_CATALOG_DIRS içinde ya da workspace.catalog_dirs altında — belirten bir çalışma alanı bunun yerine o klasörlere göre içe aktarır. İçe aktarma ardından taslak Release’in bağımlı olduğu şeyleri çeker; böylece derleme hemen ardından gelir:

Terminal window
cd source
aggrega import compose.yaml --target compose
aggrega build --release release.yaml

Derleme dist/compose/docker-compose.yaml dosyasını yazar; onu çalıştırmak yukarıda bağlantısı verilen adım adım anlatımda yer alır.

Bir yapay zekâ asistanıyla

Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.

Yalnızca Aggrega araçlarını kullanın ve kendiniz klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `import-compose` klasörü yoksa `scaffold` aracını `example` değeri `import-compose` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `import-compose` klasörüne yazar; bu klasörün `source` klasörü, bu örneğin içe aktardıklarını tutar. Ardından `import` aracını `workspace_root` değeri `import-compose/source`, `source` değeri `compose.yaml` ve `target` değeri `compose` olacak şekilde çağırın: araç ihtiyaç duyduğu yanıtları `compose.yaml` dosyasının yanındaki `import-answers.yaml` dosyasından okur, taslaklarını `import-compose/source` içine yazar ve taslakların ihtiyaç duyduklarını çeker. Ardından `validate` aracını `workspace_root` değeri `import-compose/source` ve `release` değeri `release.yaml` olacak şekilde, `build` aracını da `workspace_root` değeri `import-compose/source`, `release` değeri `release.yaml` ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `import-compose/source/dist/` altındadır.

Test edin

Yığın adım adım kılavuzun çalıştırdığı gibi çalışırken ve API için 8080 numaralı bağlantı noktasında HTTP yanıtlayan bir imaj belirtilmişken, API’ye Release’in yayımladığı bağlantı noktasından istek gönderin:

Terminal window
curl -sS http://127.0.0.1:8080/notes

Kılavuzun yerine geçen programı, aldığı isteğin bir açıklamasıyla yanıt verir:

{
"path": "/notes",
"headers": {
"host": "127.0.0.1:8080",
[… omitted: the user agent and the media types the client sent]
},
"method": "GET",
[… omitted: the rest of the request as the stand-in received it, the client's address and the container's host name]
}

Adım adım kılavuzun gösterdiği gibi --target helm ile içe aktarılıp Kubernetes’e uygulandığında, yerel bir bağlantı noktası Service’ine yönlendirildikten sonra API aynı isteğe aynı adreste yanıt verir; Secret yalnızca veritabanına ulaştığı için orada API henüz veritabanı parolasını almaz:

Terminal window
kubectl port-forward -n <namespace> svc/api-default 8080:8080