Başlayın

İlk pilotunuz: CI için tek maskelenmiş veritabanı

İlk günde tam platform kurulumu gerekmez. Ark’ın değerini en hızlı görme yolu tek bir kaynak veritabanı, bir onaylı konfigürasyon ve testlerinizin bugün bağlanabileceği bir geçici sandbox’tır.

Önerilen yol

Neden CI test veritabanıyla başlamalı?

Bu pilot tüm zinciri çalıştırır — alt kümeleme, sınıflandırmaya dayalı maskeleme, VPC’nizde agent yürütmesi ve hazır DSN — ilk günde her ekibin çalışma biçimini değiştirmeden.

  • Ham üretimi buluta kopyalamadan maskelenmiş verinin hazırlanabildiğini kanıtlayın
  • Mühendisliğe CI veya yerel test runner’a takabilecekleri hazır bir DSN gösterin
  • Alt küme boyutunu, maskeleme politikasını ve VPC içi agent yürütmesini doğrulayın
  • Staging veya daha geniş ekiplere yaymadan önce tekrarlanabilir bir kalıp oluşturun

Başlamadan önce

Önce hazır olması gerekenler

Çoğu pilot, agent veya kaynak profili hazır olmadığı için durur. CLI komutlarını çalıştırmadan bunları yönetici ve güvenlik irtibatınızla doğrulayın.

Gereksinim Sahibi Ne doğrulanmalı
Kiracı ve kullanıcılar Ark / kiracı yöneticisi Organizasyonunuzun bir kiracısı var. En az bir yönetici konsola girip mühendis davet edebilir.
VPC’nizdeki agent Platform / DevOps ark-agent geçerli bir token ile çalışıyor, konsolda heartbeat veriyor ve kontrol düzlemine outbound erişimi var.
Kaynak bağlantısı Platform / DBA Salt okunur kimlik bilgileriyle bir kaynak veritabanı kaydedin veya birincil yerine üretim replikasına bağlanın. Agent yalnızca SELECT erişimine ihtiyaç duyar — bağlantı SaaS’tan değil agent üzerinden test edilir.
Kaynak profili + konfigürasyon Güvenlik + platform Sınıflandırması incelenmiş ve maskelemesi onaylanmış bir kaynak profili vardır. Bir konfigürasyon bunu satır limitleri ve hedef ayarlara bağlar.
ark-cli veya API anahtarı Mühendislik / CI Otomasyon için bir kiracı API anahtarı oluşturun (CI için önerilir) veya konsol giriş akışından JWT ile oturum açın.

Adım adım

Önce konsol, sonra CLI

Yönetişim konsolda olur. Tekrarlanabilir hazırlama ark-cli veya CI pipeline’ınızda gerçekleşir.

Konsol

Temeli doğrulayın

  1. Ark konsoluna girin ve kiracınızı açın
  2. Agent’ın Agents altında bağlı göründüğünü doğrulayın
  3. Connections’ı açın ve kaynak veritabanının sağlıklı olduğunu doğrulayın
  4. Kaynak profilini açın — sınıflandırma incelenmiş, maskeleme kuralları onaylanmış olmalı
  5. Configs’i açın ve pilot için kullanacağınız konfigürasyon ID’sini not edin
CLI

İlk sandbox’ınızı hazırlayın

  1. ark-cli’yi dizüstü veya CI runner’ınıza kurun
  2. Kontrol düzlemi URL’si ve API anahtarı (veya JWT) ile kimlik doğrulayın
  3. configs list çalıştırın ve pilot konfigürasyon ID’sini kopyalayın
  4. --wait ile durum ready olana kadar test ortamı oluşturun
  5. Çıktıdaki DSN’i kopyalayın ve bir smoke sorgusu veya test paketi çalıştırın
Kapanış

Değeri kanıtlayın ve temizleyin

  1. Satır sayılarının ve ilişkisel bütünlüğün beklentileri karşıladığını doğrulayın
  2. Maskelenmiş alanları kontrol edin — e-posta, ad, ID ham üretim değerleri olmamalı
  3. DSN kalıbını gerçek bir test koşusu için bir mühendislik ekibiyle paylaşın
  4. Bitince test ortamını silin veya kısa bir TTL verin
  5. CI pipeline şablonunuz için konfigürasyon ID’si ve API anahtarı akışını belgeleyin

Uygulama

Kopyala-yapıştır CLI dizisi

URL, kiracı ID, API anahtarı ve konfigürasyon UUID değerlerini kendi değerlerinizle değiştirin. CI için JWT yerine API anahtarlarını tercih edin — yenileme ve giriş adımlarını atlar.

1 — Kimlik doğrula (CI: API anahtarı kullanın)

ark-cli login \
  --api-url "https://control.your-ark-instance" \
  --token "$ARK_TOKEN" \
  --tenant-id "$ARK_TENANT_ID"

2 — Konfigürasyonunuzu bulun

ark-cli configs list

3 — Maskelenmiş sandbox oluşturun ve bekleyin

ark-cli testenvs create \
  --config "550e8400-e29b-41d4-a716-446655440000" \
  --ttl "2h" \
  --wait

4 — Bitince kaldırın

ark-cli testenvs destroy "<testenv-id>"

İpucu: Kimlik bilgisi dosyası yazmaması gereken geçici CI runner’larda login yerine tek komutta --token geçin.

Doğru tamamlandı

Pilotun başarılı olduğunu nasıl anlarsınız

Agent bağlı

Konsol → Agents yakın bir heartbeat gösterir

İş tamamlandı

Test ortamı durumu hatasız ready olur

DSN çalışır

Test runner bağlanır ve sorgular maskelenmiş alt küme verisi döner

Veri sınırı korundu

VPC nesne depolamanızın dışında ham üretim dump’ı görünmedi

Pilot bitti mi?

Veri sınırları, yönetişim iş akışları ve SDK seçenekleri için tam platform rehberini okuyun. Veya işlerin SaaS ile VPC’niz arasında nasıl aktığını inceleyin.