s3 deploy

confetti/s3-deploy

tujuan | penggunaan | perubahan

Fungsi utilitas sederhana untuk membedakan dan menyinkronkan file lokal dengan bucket S3.

[confetti/s3-deploy " 0.1.4 " ] ; ; latest release 

Sasaran

• API berbasis data sederhana untuk menyinkronkan file lokal ke bucket S3
• kemampuan pelaporan yang berguna untuk memberi tahu pengguna tentang proses sinkronisasi
• izinkan beberapa pemesanan unggahan untuk mendapatkan "transaksionalitas palsu"
• izinkan spesifikasi metadata khusus
• mudah untuk membuat skrip dengan alat baris perintah Clojure

Penggunaan

Sebagian besar fungsi yang merupakan bagian dari API publik perpustakaan ini beroperasi pada peta sederhana seperti berikut, selanjutnya disebut file-maps :

{ :s3-key   " desired/destination/file.txt "
 :file     #object[java.io.File " file.txt.gz " ]
 :metadata { :content-encoding " gzip " }}

Dengan menggunakan file-maps kami memisahkan struktur sistem file dari struktur yang pada akhirnya ingin kami capai dalam bucket S3 target kami.

Secara default, :content-type metadata berasal dari ekstensi nilai yang Anda berikan sebagai :s3-key .

Sinkronisasi dapat dilakukan melalui confetti.s3-deploy/sync! :

( confetti.s3-deploy/sync! creds bucket-name file-maps)

Untuk menghasilkan file-maps dari direktori, perpustakaan ini mengirimkan pembantu kecil dir->file-maps yang akan menghasilkan peta file:

( dir->file-maps ( io/file " src " ))
; ;=> [{:s3-key "confetti/s3_deploy.clj",
; ;     :file   #object[java.io.File 0x4795c68f "/Users/martin/code/confetti-s3-deploy/src/confetti/s3_deploy.clj"]}]

Bergantung pada kasus penggunaan Anda, Anda mungkin ingin membuat fungsi penghasil file-maps Anda sendiri. Fungsi tingkat yang lebih rendah juga tersedia:

( confetti.s3-deploy/diff* bucket-objects file-maps)

Dapat digunakan untuk mendapatkan perbedaan antara objek bucket dan kumpulan file-maps tertentu.

( confetti.s3-deploy/calculate-ops bucket-objects file-maps)

Akan mengembalikan vektor operasi yang diperlukan untuk menyinkronkan bucket dengan file-maps yang disediakan.

Untuk lebih jelasnya periksa implementasinya.

Alat CLI

s3-deploy menyediakan API tingkat tinggi sehingga menarik untuk pekerjaan CLI. Berikut ini contoh minimalnya:

 ; ; cat deploy.clj
( require '[confetti.s3-deploy :as s3]
         '[clojure.java.io :as io])

( def dir-to-sync ( io/file " public " ))

( s3/sync!
  { :access-key ( System/getenv " AWS_ACCESS_KEY " )
   :secret-key ( System/getenv " AWS_SECRET_KEY " )}
  ( System/getenv " S3_BUCKET_NAME " )
  ( s3/dir->file-maps dir-to-sync)
  { :dry-run? true
   :report-fn ( fn [{ :keys [s3-key op]}]
                ( println op s3-key))})

Yang dapat dijalankan dengan:

 clj -Sdeps '{:deps {confetti/s3-deploy {:mvn/version "0.1.3"}}}' deploy.clj

Perubahan

0.1.4

• Perbarui ketergantungan skema prismatik untuk menghindari peringatan Inst

0.1.3

• skema santai seputar metadata S3 (#19)

0.1.2

• meningkatkan implementasi fungsi relative-path agar berfungsi dengan baik di Windows. (#16)