Unduh besom - Unduh Kode Sumber besom

besom

Kode sumber lainnya

v0.3.2

Unduh

Sapu

BESOM - Sapu yang terbuat dari ranting yang diikat di sekitar tongkat. Sapu dan BESOM digunakan untuk perlindungan, untuk menangkal roh jahat, dan pembersihan ruang ritual. Juga, Besom adalah Scala SDK yang memungkinkan Anda untuk menulis program Pulumi di Scala, kebetulan.

Logo Besom

Besom Scala SDK untuk Pulumi memungkinkan Anda memanfaatkan kekuatan penuh infrastruktur Pulumi sebagai platform kode menggunakan bahasa pemrograman Scala. Dukungan Scala saat ini dalam beta publik .

Pulumi adalah merek dagang terdaftar dari Pulumi Corporation.

Selamat datang

Mulailah dengan Besom : Menyebarkan aplikasi sederhana di AWS, Azure, Google Cloud atau Kubernetes menggunakan BESOM untuk menggambarkan infrastruktur yang diinginkan menggunakan Scala.
BESOM DOCS : Pelajari tentang konsep BESOM, ikuti panduan pengguna, dan berkonsultasi dengan dokumentasi referensi.
Contoh : Jelajahi Contoh Scala di banyak awan dan skenario termasuk wadah, tanpa server, dan infrastruktur.

Memulai

Instal Pulumi Cli :
Untuk menginstal rilis Pulumi terbaru, jalankan yang berikut (lihat instruksi instalasi lengkap untuk opsi instalasi tambahan):
```
curl -fsSL https://get.pulumi.com/ | sh
```
Instal Scala Cli :
Untuk menginstal rilis Scala CLI terbaru, jalankan berikut ini (lihat Instruksi Instalasi untuk Opsi Instalasi Tambahan):
```
curl -sSLf https://scala-cli.virtuslab.org/get | sh
```
Instal Plugin Bahasa Scala di Pulumi :
Untuk menginstal rilis plugin bahasa Scala terbaru, jalankan yang berikut:
```
pulumi plugin install language scala 0.3.2 --server github://api.github.com/VirtusLab/besom
```
Buat proyek baru :
Anda dapat mulai menulis kode BESOM Anda pada saat ini, tetapi untuk membantu Anda mengatur Besom dilengkapi dengan templat Pulumi.
Anda dapat memulai dengan perintah pulumi new :
```
mkdir besom-demo && cd besom-demo
```
```
pulumi new https://github.com/VirtusLab/besom/tree/v0.3.2/templates/aws
```
Menyebarkan ke cloud :
Jalankan pulumi up untuk membawa kode Anda ke cloud:
```
pulumi up
```
Ini membuat semua sumber daya cloud dinyatakan dalam kode Anda. Cukup lakukan pengeditan ke proyek Anda, dan pulumi up berikutnya akan menghitung diff minimal untuk menggunakan perubahan Anda.
Gunakan program Anda :
Sekarang kode Anda digunakan, Anda dapat berinteraksi dengannya. Dalam contoh di atas, kita dapat menemukan nama ember S3 yang baru disediakan:
```
pulumi stack output bucketName
```
Hancurkan Sumber Daya Anda :
Setelah selesai, Anda dapat menghapus semua sumber daya yang dibuat oleh program Anda:
```
pulumi destroy -y
```

Untuk mempelajari lebih lanjut, pergilah ke virtuslab.github.io/besom untuk informasi lebih lanjut, termasuk tutorial, contoh, dan konsep model arsitektur dan pemrograman.

Menjelaskan struktur proyek

Pulumi.yaml adalah file Pulumi utama Anda, dijelaskan di sini.

project.scala adalah file yang berisi dependensi Anda untuk Scala-Cli.

Main.scala adalah titik masuk untuk infrastruktur Anda sebagai kode.

Sumber daya yang dibuat di blok Pulumi.run { ... } akan dibuat oleh Pulumi.

Contoh sederhana menggunakan Scala Cli:

 //> using scala " 3.3.1 "
//> using plugin " org.virtuslab::besom-compiler-plugin:0.3.2 "
//> using dep " org.virtuslab::besom-core:0.3.2 "
//> using dep " org.virtuslab::besom-aws:6.31.0-core.0.3 "

import besom . *
import besom . api . aws

@ main def run = Pulumi .run {
   val bucket = aws.s3. Bucket ( " my-bucket " )

   Stack .exports(
      bucketName = bucket.bucket
   )
}

Catatan

Harap perhatikan dependensi Anda, hanya gunakan org.virtuslab::besom-* dan bukan com.pulumi:* . BESOM tidak bergantung pada Pulumi Java SDK , ini adalah implementasi yang sepenuhnya terpisah.

Tips

Sumber daya diinisialisasi dengan malas. Untuk membuatnya muncul dalam infrastruktur fisik Anda, pastikan evaluasi mereka dipicu secara langsung atau transitif (dengan merujuk mereka atau sumber daya yang bergantung pada mereka) dengan memasukkannya ke dalam struktur Stack akhir program Anda.
Gunakan konsep scala apa pun yang Anda kenal, infrastruktur sebagai kode di Besom masih merupakan program Scala, jadi Anda memiliki potensi penuh bahasa untuk dikerjakan.
Perhatikan jenisnya. Anda akan membuat kelas kasus instantiating untuk lulus parameter, perhatikan paket asal mereka.
Beberapa fungsi pulumi yang memungkinkan Anda mengakses metadata tumpukan saat ini memerlukan akses ke Context . Context tersedia sebagai yang diberikan (secara implisit) di blok Pulumi.run , tetapi Anda juga dapat mengharuskannya secara eksplisit dalam fungsi Anda dengan (using Context) .

Persyaratan

JDK 11 atau lebih tinggi diperlukan
Scala 3.3.1 atau lebih tinggi diperlukan

Scala CLI adalah alat build yang disarankan, alat lain juga didukung. BESOM akan mengenali program Scala CLI dan SBT dan secara otomatis mengkompilasi ulangnya tanpa konfigurasi lebih lanjut. Versi yang didukung adalah:

Scala CLI 1.0.4 atau lebih tinggi
SBT 1.9.6 atau lebih tinggi
Apache Maven 3.8.4 atau lebih tinggi
Alat Bangun Lulusan 7.4 atau lebih tinggi

Alat build lainnya didukung melalui runtime.options.binary Opsi Konfigurasi Binary yang dapat menunjuk ke toples yang sudah dibangun di Pulumi.yaml , misalnya:

 name : myproject
runtime :
  name : scala
  options :
    binary : target/myproject-1.0-SNAPSHOT-jar-with-dependencies.jar

Pilihan alat dan IDE build

Besom menggunakan Scala-Cli untuk kompilasi dan eksekusi proyek.

Untuk mengatur dukungan IDE untuk proyek infrastruktur menggunakan BESOM mengeksekusi perintah ini di dalam direktori di mana file proyek BESOM ada:

scala-cli setup-ide .

Sebagai hasil dari perintah ini, direktori .bsp akan dibuat di dalam direktori proyek.

Saat dibuka, ide intellij dan logam harus secara otomatis mengenali proyek dan mengatur IDE sesuai.

SBT, Gradle dan Maven juga didukung di luar kotak, tetapi tidak disarankan karena kecepatan iterasi yang lebih lambat. Penggunaan dukungan sbt , gradle atau mvn disarankan untuk situasi di mana infrastruktur yang dikelola ditambahkan ke proyek yang sudah ada yang menggunakan SBT sebagai alat pembangun utama.

Pengaturan IDE untuk sbt , gradle atau mvn bekerja secara otomatis dengan ide intelliJ dan logam.

Mill belum didukung.