Buat instans PAI-Instant Service pertama Anda melalui jalur tercepat: buat layanan instan, luncurkan instans dari templat publik, jalankan perintah dengan E2B SDK, lalu hapus instans tersebut.
Prasyarat
Sebelum menggunakan PAI-Instant Service, pastikan Anda telah menyelesaikan persiapan berikut:
Akun Alibaba Cloud telah diaktifkan dan verifikasi nama asli telah selesai.
PAI telah diaktifkan dan ruang kerja PAI telah dibuat.
Sumber daya komputasi Instant Service telah dibeli di halaman pembelian EAS Dedicated Machine Pay-As-You-Go.
(Opsional) Untuk membuat templat dari custom image, aktifkan Container Registry (ACR) dan buat instans Standard atau Premium ACR Enterprise Edition. Jika hanya menggunakan templat publik, ACR tidak diperlukan.
(Opsional) Saat menggunakan E2B Python SDK, hanya versi sebelum v2.25.0 yang didukung.
Langkah 1: Buat layanan instan
Login ke Konsol PAI. Di panel navigasi kiri, pilih Elastic Algorithm Service (EAS) untuk membuka halaman daftar layanan.
Beralih ke tab Instant Service di bagian atas.
Klik Create Instant Service dan konfigurasikan parameter berikut. Biarkan parameter lain tetap pada nilai default:
Name: Masukkan nama kustom, misalnya
quickstart.Resource Type: Pilih EAS Resource Group.
Resource Group:Pilih resource group Instant Service yang telah Anda beli.
Network Egress Mode: Pilih Shared Public Network.
Klik Confirm untuk menyelesaikan pembuatan.
Untuk detail parameter dan Konfigurasi Lanjutan, lihat Kelola layanan instan dan templat.
Langkah 2: Pilih templat publik
PAI-Instant Service menyediakan templat publik siap pakai seperti code-interpreter, browser, dan desktop. Panduan ini menggunakan code-interpreter — tidak diperlukan templat kustom.
Buka workbench layanan instan.
Di tab Instant Service, temukan layanan instan yang Anda buat di Langkah 1. Di kolom Invoke, klik ikon Instant Service Workbench.
Di kotak dialog Go to Instant Service Workbench, salin URL Manage Links atau Read-only Link lalu buka di browser Anda.
Dalam daftar templat publik, pilih
code-interpreterlalu klik ID templat untuk membuka halaman detail templat.Di pojok kanan atas halaman detail templat, klik SDK Access untuk mendapatkan konfigurasi koneksi SDK dan contoh kode Python.
Langkah 3: Buat instans dan jalankan perintah dengan SDK
Instal E2B SDK
pip install "e2b<2.25.0" Contoh lengkap
Contoh berikut menunjukkan alur kerja instans lengkap: buat instans, ambil informasi instans, jalankan perintah, baca dan tulis file, lalu hapus instans.
Ganti <YOUR-API-TOKEN> dan <YOUR-DOMAIN> dengan nilai yang Anda peroleh di Langkah 2.
import os
from e2b import Sandbox
import time
# 1. Setel kredensial autentikasi
os.environ["E2B_API_KEY"] = "<YOUR-API-TOKEN>"
os.environ["E2B_DOMAIN"] = "<YOUR-DOMAIN>"
# 2. Buat instans
sandbox = Sandbox.create(
template="<YOUR-TEMPLATE-ID>",
timeout=300000, # Timeout (milidetik)
)
print(f"Sandbox ID: {sandbox.sandbox_id}")
# Tunggu hingga instans memasuki status Berjalan
print("Menunggu sandbox siap...")
max_attempts = 30
for attempt in range(1, max_attempts + 1):
try:
is_running = sandbox.is_running()
status = "Running" if is_running else "Not Running"
print(f" [{attempt}/{max_attempts}] Status sandbox: {status}")
if is_running:
print(" ✓ Sandbox kini sedang berjalan!")
break
except Exception as e:
print(f" [{attempt}/{max_attempts}] Gagal memeriksa status: {e}")
if attempt < max_attempts:
time.sleep(2)
# 3. Dapatkan detail instans (termasuk metadata dan URL Dasbor)
info = sandbox.get_info()
print(f"Status: {info.state}")
print(f"CPU: {info.cpu_count}, Memori: {info.memory_mb}MB")
# Cetak metadata
if info.metadata:
print("\nMetadata:")
for key, value in info.metadata.items():
print(f" {key}: {value}")
# Dapatkan URL Dasbor
dashboard_url = info.metadata.get('sandbox.alicloud.com/dashboard-url') or \
info.metadata.get('dashboard_url')
if dashboard_url:
print(f"\nURL Dasbor: {dashboard_url}")
# 4. Jalankan perintah
result = sandbox.commands.run("echo 'Hello, World!'")
print(result.stdout)
# 5. Operasi file
sandbox.files.write("/tmp/test.txt", "Hello from sandbox!")
content = sandbox.files.read("/tmp/test.txt")
print(content)
# 6. Bersihkan
sandbox.kill() Langkah 4: Bersihkan sumber daya
Setelah Anda memanggil
sandbox.kill()untuk menghapus instans, penagihan untuk sumber daya komputasi maupun sistem disk akan berhenti.Anda juga dapat menemukan instans tersebut di Instance list dalam workbench layanan instan lalu klik Delete untuk menghapusnya.
Jika Anda tidak lagi membutuhkan layanan instan, Anda dapat menghapusnya dari daftar layanan instan.
Instans yang belum memanggil kill() atau belum mencapai timeout akan terus dikenai biaya. Instans yang di-pause juga ditagih dengan laju yang sama seperti saat Berjalan. Untuk detail selengkapnya, lihat Penagihan.
Langkah selanjutnya
Gunakan SDK untuk operasi lifecycle, perintah, dan file lebih lanjut: Integrasi E2B SDK
Gunakan templat publik untuk lingkungan browser, desktop, coding, dan lainnya: Gunakan templat publik
Debug instans menggunakan terminal konsol, VNC, manajemen file, dan panel lainnya: Kelola instans
Buat templat dari custom image: Kelola layanan instan dan templat