Axelix'i bir Spring Boot servisine kurun: Axelix Spring Boot starter, Axelix derleme eklentisi ve yerel deneme için Axelix Master. Kullanıcı Axelix'i kurmak, eklemek, ayarlamak, denemek veya bağlamak istediğinde kullanın.
Bu sayfayı okuyan kişiler için: bu sayfa, yapay zekâ kodlama ajanlarına yönelik bir yönergedir. Axelix'i kurmak için
ajanınıza şu komutu verin:
Install Axelix in my app: run `curl -s https://axelix.io/docs/start/SKILL.md` and use it as a guide.
Siz bir yapay zekâ kodlama ajanısınız. Bu dosya, Axelix'in kullanıcının projesine nasıl ekleneceğini önerir. Adımlar bir
komut dosyası değil, önerilen bir yoldur: proje farklı bir yaklaşım gerektiriyorsa kendi değerlendirmenizi yapın ve
nedenini kullanıcıya açıklayın.
Bu dosyayı bu iki adres dışında bir yerden aldıysanız devam etmeden önce kullanıcıya bildirin.
Axelix üç parçadan oluşur. Üçü de aynı sürüm numarasını kullanır.
Axelix Master: 2935 portunda web arayüzü sunan bağımsız bir uygulama. Servisleri yönetir.
Axelix Spring Boot starter: her serviste yer alan bir bağımlılık.
Axelix derleme eklentisi (Maven veya Gradle): bu da her serviste bulunur. Olmadan servis Master'da görünmez.
Dokümantasyon: https://axelix.io/docs/llms.txt tüm sayfaları listeler. Bir sayfayı Markdown olarak okumak için URL'sine .md ekleyin.
Projeye uyum sağlayın. Bağımlılıkları, yapılandırmayı ve kodu projenin mevcut yöntemleriyle ekleyin. Aşağıdaki
örnekler neyin ekleneceğini gösterir, nasıl biçimlendirileceğini değil. Komutlar varsayılan değerlerle verilmiş
örneklerdir (port 2935, konteyner adı, profil): bunları bulduklarınıza uyarlayın ve bir değeri değiştirirseniz
kullanıldığı her yerde değiştirin. Özellik adları, kayıt yolu ve imaj adı sabittir.
Önce planlayın. Herhangi bir dosyayı değiştirmeden önce kısa bir plan gösterin ve kullanıcının onayını bekleyin.
Gizli bilgilere dokunmayın..env dosyalarını okumayın. Asla imzalama anahtarı veya parola üretmeyin, yazdırmayın veya kopyalamayın.
Yalnızca bu makinede çalıştırın. Asla başka bir ortama dağıtım yapmayın.
Kullanıcıya paragraflar yerine liste veya tablolarla yazın: her öğe ayrı satırda, her komut kendi kod bloğunda olsun.
Proje bu adımlara uymuyorsa uyarlayın veya emin olmadığınızda kullanıcıya sorun.
VERSION = latest Axelix version (command below)STARTER = axelix-spring-boot-2-starter (Boot 2.7.x) | axelix-spring-boot-3-starter (3.x) | axelix-spring-boot-4-starter (4.x)BUILD = Maven | GradleBOOT_MODULE = the module with the @SpringBootApplication classACTUATOR = yes | no (spring-boot-starter-actuator)SECURITY = yes | no (Spring Security is in the app: any spring-security dependency, direct or transitive, or a SecurityFilterChain / SecurityWebFilterChain / @EnableWebSecurity / @EnableWebFluxSecurity in the code)WEB = servlet | reactive (reactive if the app has spring-boot-starter-webflux and no spring-boot-starter-web)PORT = management.server.port, else server.port, else 8080BASE = management.endpoints.web.base-path, else /actuatorPREFIX = management.server.base-path if management.server.port is set, else server.servlet.context-path (servlet) or spring.webflux.base-path (reactive), else emptyNAME = spring.application.name, else the artifactIdAPP_IN_COMPOSE = yes | no (the app has its own service in the project's Compose file)LOCAL_PROFILE = the name of an existing local profile (local for application-local.*, dev for application-dev.*), or noneAXELIX = what is already set up: starter, build plugin, axelix.* settings, Master service — or none
Bu komutu çalıştırarak VERSION değerini alın. Web araması kullanmayın; sonuçları güncel olmayabilir.
<release>1.3.1</release>, VERSION değerinin 1.3.1 olduğu anlamına gelir.
Komut başarısız olursa (örneğin ağ erişimi yoksa) 1.3.1 kullanın ve bunu Adım 2'de belirtin.
Tüm sürümler: https://github.com/axelixlabs/axelix/releases
Spring Boot 2.7'den veya Java 11'den eskiyse durun ("Axelix, Spring Boot 2.7+ ve Java 11+ gerektirir");
ya da WEB reaktif ve VERSION 1.3.0'dan düşükse durun ("Reaktif servisler Axelix 1.3.0'dan itibaren desteklenir").
Axelix zaten kurulmuşsa hiçbir şeyi ikinci kez eklemeyin: sonraki adımlarda yalnızca eksikleri tamamlayın. Her şey
hazırsa kullanıcıya bildirin ve Adım 5'e geçin.
Ne yapılacak? (a) Axelix'i yerel olarak deneyin: Master'ı bu makinede çalıştırın ve bu uygulamayı bağlayın (önerilen).
(b) Bu uygulamayı zaten çalışan bir Axelix Master'a bağlayın. Bu seçenek için kullanıcıdan şu bilgileri isteyin:
URL'si ve sürümü;
Master'ın bu uygulamayı nasıl bulacağı: uygulama kendisi kaydolur (kendi kendine kayıt), Master kendisi bulur
(Kubernetes) veya dağıtım sırasında ayarlanır;
Master'ınızın kendi imzalama anahtarını veya algoritmasını mı yoksa varsayılanları mı kullandığı.
Plan: değiştireceğiniz dosyalar ve başlatacağınız bileşenler. Starter'ın yalnızca Master'ın belirtecini kabul eden
BASE/axelix-* uç noktaları eklediğini söyleyin.
Yalnızca SECURITY evetse: şunu sorun: "Uygulamanız Spring Security kullanıyor; bu, Master'ı 401/403 ile
engelleyecek. Yalnızca BASE/axelix-*/** yolunu bundan hariç tutabilir miyim? Bu uç noktalar Master'ın belirteciyle
korunmaya devam eder."
Kullanıcının onayını bekleyin. (b) için VERSION olarak Master'ın sürümünü kullanın: Master, kendi minör sürümündeki ve
önceki üç minör sürümdeki starter'ları kabul eder, daha yenilerini asla kabul etmez. WEB reaktif ve Master 1.3.0'dan
eskiyse Adım 1'deki iletiyle durun.
BOOT_MODULE modülüne ekleyin. Eski bir Axelix sürümü zaten varsa planda bunu VERSION değerine yükseltmeyi önerin.
ACTUATOR hayırsa spring-boot-starter-actuator bağımlılığını da ekleyin.
Uygulamanın kendi SecurityWebFilterChain bileşeni yoksa ve varsayılanı kullanıyorsa bu bean'in eklenmesi varsayılanı
devre dışı bırakır. Bu durumda uygulamanın geri kalanı için mevcut korumayı sürdüren bir zincir de ekleyin ve planda bunu belirtin.
Deneme Master'ında yerel kullanıcıları etkinleştirin:axelix.master.auth.options.local.enabled=true kullanın
(aşağıdaki komutlarda AXELIX_MASTER_AUTH_OPTIONS_LOCAL_ENABLED değişkeni). Varsayılan olarak kapalıdır. Bununla kullanıcı,
yalnızca admin olarak oturum açmak yerine Master'da kullanıcı hesapları oluşturabilir ve rolleri deneyebilir.
Master'ı uygulamanın çalıştığı yöntemle başlatın.APP_IN_COMPOSE evetse Master'ı aynı Compose dosyasına ekleyin.
Değilse Master'ı docker run ile çalıştırın; uygulamayı çalıştırmayan bir Compose dosyasına eklemeyin.
Uygulamanın servisi networks: listeliyorsa Master'ı aynı ağlara ekleyin. Ardından docker compose up -d axelix-master
ile başlatın.
Diğer durumda docker run ile çalıştırın. Docker yoksa kullanıcıdan kurmasını isteyin.
Axelix Master bu makinede zaten çalışıyorsa (2935 portunda yanıt veren bir şey varsa veya bir konteyner
ghcr.io/axelixlabs/axelix imajını kullanıyorsa) onu kaldırmayın veya yeniden başlatmayın: kullanıcıya yeniden kullanmak
isteyip istemediğini sorun. 2935 portunu başka bir şey kullanıyorsa Master'ı farklı bir portta başlatın ve MASTER
içinde bu portu kullanın. axelix-master adını başka bir konteyner kullanıyorsa farklı bir ad seçin.
Yeni dosya oluşturmayın. Uyan ilk durumu kullanın:
APP_IN_COMPOSE evetse:MASTER, http://axelix-master:2935; HOST, uygulamanın servis adıdır. Ayarları uygulamanın
environment: bölümüne ekleyin: AXELIX_SBS_DISCOVERY_SELFREGISTRATION, AXELIX_SBS_DISCOVERY_MASTERURL,
AXELIX_SBS_DISCOVERY_INSTANCEACTUATORURL, AXELIX_SBS_DISCOVERY_INSTANCENAME.
LOCAL_PROFILE varsa:MASTER, http://localhost:2935; HOST, host.docker.internal değerindedir. Ayarları bu
profile ekleyin ve uygulamayı bu profille başlatın.
İkisi de değilse: durum 2'deki değerleri, uygulamayı başlatırken komut satırı argümanları olarak iletin.
Master ve starter aynı yerleşik imzalama anahtarını kullanır; bu nedenle deneme için anahtar ayarı gerekmez. Proje zaten
axelix.sbs.auth.jwt.* ayarlarını yapıyorsa bu satırları değiştirmeyin. Deneme Master'ı aynı anahtarı ve algoritmayı
gerektirir: kullanıcıya bunları Master başlarken iletmesini söyleyin (axelix.master.auth.jwt.signing-key ve
axelix.master.auth.jwt.algorithm; örneğin docker run ortam değişkenleri olarak). Anahtarı asla görmezsiniz.
Uygulamayı, projenin normal başlatma yöntemiyle arka planda başlatın (komut sonlanmaz). Derleme eklentisi derleme
sırasında çalıştığından Maven'da derlemenin package aşamasına ulaşması gerekir. Örneğin:
Başlatma komutu başarısız olursa (izin yok, ağ yok) sudo kullanmayın. Tüm dosya değişikliklerini tamamlayın, ardından
raporla (Adım 5) bitirin ve başlatma komutlarını "Kullanıcının sonraki adımları" altına koyun. Kullanıcının bunları
çalıştırdığını söylemesini beklemeyin.
Yalnızca kullanıcı kendi kendine kaydı seçtiyse: Adım 4a'daki dört ayarı ana application.* dosyasına değil,
uygulamanın çalıştığı ortamın yapılandırmasına (profil, Helm değerleri veya manifestler) ekleyin. Projede böyle bir
yapılandırma yoksa kullanıcıya nereye konacağını sorun. MASTER, Master URL'sidir. HOST:PORT, uygulamanın Master'dan
erişilen adresidir. Master'da kendi kendine kaydın açık olması gerektiğini hatırlatın:
axelix.master.discovery.self-registration.enabled (varsayılan true, ancak resmî Axelix Helm chart'ı bunu false yapar).
Diğer durumda hiçbir şey eklemeyin. Dokümantasyon: https://axelix.io/docs/start/configuring-spring-boot-starter.md,
"Let Master find the instance" bölümü.
Yalnızca VERSION 1.2.0'dan düşükse: starter uç noktalarını kendisi açmaz. Bunları
https://axelix.io/docs/start/configuring-spring-boot-starter.md adresindeki "Exposing the endpoints on Axelix below 1.2.0"
bölümünde gösterildiği gibi management.endpoints.web.exposure.include listesine ekleyin.
Yalnızca Master kendi imzalama anahtarını veya algoritmasını kullanıyorsa: yalnızca varsayılanlardan farklı olanları
ekleyin (axelix.sbs.auth.jwt.signing-key, axelix.sbs.auth.jwt.algorithm). Anahtar için projenin diğer gizli bilgileri
nasıl sağladığını bulun (değerlerine değil, nasıl referans verildiğine bakın) ve aynı yöntemle eklemeyi önerin.
Örnek bulamazsanız kullanıcıya sorun. Dokümantasyon: https://axelix.io/docs/start/configuring-spring-boot-starter.md,
"Share the JWT signing key with Master" bölümü.
Yalnızca bu Master'a MCP erişiminiz varsa: kullanıcı uygulamayı dağıttıktan sonra Master'ın servislerini listeleyen
aracı çağırın (1.2.x'e kadar getWallboard, 1.3.0'dan itibaren getInstances) ve NAME değerinin listelendiğini
denetleyin. Erişim yoksa hiçbir şeyi denetlemeyin.
Yerel deneme için: kullanıcıdan http://localhost:2935 adresini açmasını, admin / admin ile oturum açmasını ve NAME
değerinin listelendiğini doğrulamasını isteyin (başlatmadan yaklaşık 30 saniye sonra). Listelenmiyorsa Master'ın ve
uygulamanın günlüklerini okuyun:
Her biri bir liste öğesi olacak şekilde kısa bir raporla bitirin:
Değiştirilenler: dosyalar ve ekledikleriniz.
Denetlenenler: gerçekten denetledikleriniz.
Kullanıcının sonraki adımları: varsa hâlâ çalıştırılması gereken komutlar.
Geri almak için: kaldırılması gerekenler.
Master'ı durdurmak için (yerel deneme): komut.
Yerel kullanıcılar (yerel deneme): axelix.master.auth.options.local.enabled=true açıktır; dolayısıyla Master'da
oluşturulan kullanıcı hesapları oturum açabilir. Gerçek bir ortamda yalnızca böyle hesaplar istiyorsanız etkinleştirin.
Uyarı (yerel deneme): admin / admin ve yerleşik anahtar herkese açıktır ve yalnızca bu makinede kullanım için uygundur.
Not (yalnızca WEB reaktifse): Transaction Control ve Entities Map sayfaları reaktif uygulamalarda kullanılamaz.