Cara Mempublikasikan Aplikasi - AWS Serverless Application Repository

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Cara Mempublikasikan Aplikasi

Bagian ini memberi Anda prosedur untuk menerbitkan aplikasi tanpa server Anda keAWS Serverless Application Repositorydengan menggunakanAWS SAMCLI atauAWS Management Console. Ini juga menunjukkan cara membagikan aplikasi Anda untuk memungkinkan orang lain menerapkannya, dan menghapus aplikasi Anda dariAWS Serverless Application Repository.

penting

Informasi yang Anda masukkan saat memublikasikan aplikasi tidak dienkripsi. Informasi ini mencakup data seperti nama penulis. Jika Anda memiliki informasi identitas pribadi yang tidak ingin disimpan atau dipublikasikan, sebaiknya Anda tidak memasukkan informasi ini saat menerbitkan aplikasi Anda.

Menerbitkan Aplikasi (AWS CLI)

Cara termudah untuk mempublikasikan aplikasi keAWS Serverless Application Repositoryadalah dengan menggunakan satu setAWS SAMPerintah CLI. Untuk informasi selengkapnya, lihatMenerbitkan Aplikasi MenggunakanAWS SAMCLIdiAWS Serverless Application Model(AWS SAMPanduan Developer.

Menerbitkan Aplikasi Baru (Konsol)

Bagian ini menunjukkan cara menggunakanAWS Management Consoleuntuk mempublikasikan aplikasi baru keAWS Serverless Application Repository. Untuk informasi tentang memublikasikan versi baru aplikasi yang sudah ada, lihatMenerbitkan Versi Baru dari Aplikasi yang Ada.

Prasyarat

Sebelum Anda mempublikasikan aplikasi keAWS Serverless Application Repository, Anda memerlukan yang berikut ini:

  • ValidAWSakun.

  • ValidAWS Serverless Application Model(AWS SAM) template yang mendefinisikanAWSsumber daya yang digunakan. Untuk informasi lebih lanjut tentangAWS SAMtemplate, lihatAWS SAMDasar-Dasar Template.

  • Sebuah paket untuk aplikasi Anda yang Anda buat dengan menggunakanAWS CloudFormation packageperintah untukAWS CLI. Perintah ini paket artefak lokal (jalur lokal) yang AndaAWS SAMreferensi template. Untuk detail selengkapnya, lihatpaketdiAWS CloudFormationdokumentasi.

  • URL yang menunjuk ke kode sumber aplikasi Anda, jika Anda ingin mempublikasikan aplikasi Anda secara publik.

  • Sebuah file readme.txt. File ini harus menjelaskan cara pelanggan dapat menggunakan aplikasi Anda, dan cara mengonfigurasinya sebelum men-deploynya sendiriAWSakun.

  • Sebuah file license.txt atau pengenal lisensi yang valid dariSitus SPDX. Perhatikan bahwa lisensi hanya diperlukan jika Anda ingin membagikan aplikasi Anda secara publik. Jika Anda akan menjaga aplikasi Anda tetap pribadi atau hanya membagikannya secara pribadi, Anda tidak perlu menentukan lisensi.

  • Kebijakan bucket Amazon S3 yang memberikan layanan izin baca untuk artefak yang diunggah ke Amazon S3 ketika Anda mengemas aplikasi Anda. Untuk mengatur kebijakan ini, ikuti langkah-langkah ini:

    1. Buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

    2. Pilih bucket Amazon S3 yang Anda gunakan untuk mengemas aplikasi Anda.

    3. Pilih tab Izin.

    4. PilihKebijakan embertombol.

    5. Tempelkan pernyataan kebijakan berikut keEditor kebijakan bucket. Pastikan untuk mengganti nama bucket Anda diResourceelemen, danAWSID akun diConditionelemen. Ekspresi dalamConditionelemen memastikanAWS Serverless Application Repositoryhanya memiliki izin untuk mengakses aplikasi dari yang ditentukanAWSakun. Untuk informasi selengkapnya tentang pernyataan kebijakan, lihat Referensi elemen kebijakan JSON IAM di Panduan Pengguna IAM.

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "serverlessrepo.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::bucketname/*", "Condition" : { "StringEquals": { "aws:SourceAccount": "123456789012" } } } ] }
    6. Pilih tombol Simpan.

Prosedur

Membuat aplikasi baru diAWS Serverless Application Repositorydengan menggunakan prosedur berikut.

Untuk membuat aplikasi baru diAWS Serverless Application Repository
  1. BukaAWS Serverless Application Repositorykonsoldan pilihMemublikasikan aplikasi.

  2. PadaPublikasikan aplikasihalaman, masukkan informasi aplikasi berikut, lalu pilihMemublikasikan aplikasi:

    Properti Diperlukan Deskripsi
    Nama aplikasi BENAR

    Nama aplikasi.

    Panjang minimum=1. Panjang maksimum=140.

    Pola: “[a-zA-Z0-9\ -] +”;

    Penulis BETUL

    Nama penulis yang memublikasikan aplikasi.

    Panjang minimum=1. Panjang maksimum=127.

    Pola: “^ [a-z0-9] ([a-z0-9] |- (?! -) * [a-z0-9])? $”;

    Halaman Beranda SALAH URL dengan informasi selengkapnya tentang aplikasi—misalnya, lokasi Anda GitHub repositori untuk aplikasi.
    Deskripsi BETUL

    Deskripsi aplikasi.

    Panjang minimum=1. Panjang maksimum=256.

    Label SALAH

    Label yang meningkatkan penemuan aplikasi di hasil pencarian.

    Panjang minimum=1. Panjang maksimum=127. Jumlah maksimum label: 10.

    Pola: “^ [a-zA-Z0-9+\ -_:\\ /@] +$”;

    Lisensi SPDX (daftar drop-down) SALAH Pilih pengenal lisensi yang valid dari drop-down yang berisi lisensi yang tersedia diSitus SPDX. Memilih item di drop-downLisensikotak teks di bawahnya. Catatan: Memilih lisensi di drop-down menggantikan isiLisensikotak teks, dan membuang suntingan manual yang telah Anda buat.
    Lisensi SALAH

    Unggah file lisensi.txt, atau pilih lisensi darilisensi SPDXdrop-down dijelaskan di baris sebelumnya. Memilih lisensi darilisensi SPDXdrop-down secara otomatis mengisiLisensikotak teks. Anda dapat mengedit isi kotak teks ini secara manual setelah mengunggah file lisensi atau memilih salah satu darilisensi SPDXdrop-down. Namun, jika lainlisensi SPDXdipilih dari drop-down, setiap suntingan manual yang telah Anda buat dibuang.

    Ini adalah bidang opsional, tetapi Anda harus memberikan lisensi untuk berbagi aplikasi secara publik.

    Readme SALAH

    Upload isi file Readme, yang dapat dalam format teks atau penurunan harga. Isi ini ditampilkan pada halaman detail aplikasi diAWS Serverless Application Repository. Anda dapat mengedit isi kotak teks ini secara manual setelah mengunggah file.

    Versi semantik SALAH

    Versi semantik aplikasi. Untuk informasi selengkapnya, lihatSitus Semantic Versioning.

    Anda harus memberikan nilai untuk properti ini agar dapat membuat aplikasi Anda publik.

    Url kode sumber SALAH Tautan ke repositori publik untuk kode sumber aplikasi Anda.
    Templat SAM BETUL

    ValidAWS Serverless Application Model(AWS SAM) template yang mendefinisikanAWSsumber daya yang digunakan.

Berbagi Aplikasi

Aplikasi yang diterbitkan dapat memiliki izin yang ditetapkan dalam salah satu dari tiga kategori berikut:

  • Pribadi (default)— Aplikasi yang dibuat dengan akun yang sama, dan belum dibagikan dengan yang lainAWSakun. Hanya konsumen yang berbagiAWSakun memiliki izin untuk menyebarkan aplikasi pribadi.

  • Dibagikan secara pribadi— Aplikasi yang telah dibagikan oleh penerbit secara eksplisit dengan satu set tertentuAWSakun, atau denganAWSakun dalamAWSOrganisasi. Konsumen memiliki izin untuk menyebarkan aplikasi yang telah dibagikan kepada pelangganAWSakun atauAWSOrganisasi. Untuk informasi selengkapnya tentang AWS Organizations, lihat Panduan Pengguna AWS Organizations.

  • Dibagikan publik— Aplikasi yang telah dibagikan oleh penerbit dengan semua orang. Semua konsumen memiliki izin untuk menyebarkan aplikasi yang dibagikan secara publik.

Setelah Anda menerbitkan aplikasi keAWS Serverless Application Repository, secara default diatur keprivat. Bagian ini menunjukkan cara untuk membagikan aplikasi secara pribadi dengan spesifikAWSakun atauAWSOrganisasi, atau berbagi secara terbuka dengan semua orang.

Berbagi Aplikasi Melalui Konsol

Anda memiliki dua opsi untuk membagikan aplikasi Anda dengan orang lain: 1) Bagikan dengan spesifikAWSakun atauAWSakun dalamAWSorganisasi, atau 2) Bagikan secara terbuka dengan semua orang. Untuk informasi selengkapnya tentang AWS Organizations, lihat Panduan Pengguna AWS Organizations.

Opsi 1: Untuk berbagi aplikasi Anda dengan spesifikAWSakun atau akun dalamAWSorganisasi
  1. Buka konsol AWS Serverless Application Repository.

  2. Pada panel navigasi, pilihAplikasi yang dipublikasikanuntuk memunculkan daftar aplikasi yang telah Anda buat.

  3. Pilih aplikasi yang ingin Anda bagikan.

  4. PilihPembagiantab.

  5. DiPernyataan kebijakan aplikasibagian, pilihMembuat Pernyataantombol.

  6. DiKonfigurasi pernyataanjendela mengisi bidang berdasarkan bagaimana Anda ingin berbagi aplikasi Anda.

    catatan

    Jika Anda berbagi dengan organisasi, Anda hanya dapat menentukan organisasi yang AndaAWSakun adalah anggota dari. Jika Anda mencoba untuk menentukanAWSOrganisasi bahwa Anda bukan anggota, kesalahan akan mengakibatkan.

    Untuk berbagi aplikasi Anda denganAWSOrganisasi, Anda harus mengakui bahwaUnshareApplicationtindakan akan ditambahkan ke pernyataan kebijakan Anda, jika berbagi perlu dicabut di future.

  7. Pilih tombol Simpan.

Opsi 2: Untuk berbagi aplikasi Anda secara publik dengan semua orang
  1. Buka konsol AWS Serverless Application Repository.

  2. Pada panel navigasi, pilihAplikasi yang dipublikasikanuntuk memunculkan daftar aplikasi yang telah Anda buat.

  3. Pilih aplikasi yang ingin Anda bagikan.

  4. PilihPembagiantab.

  5. DiBerbagi publikbagian, pilihMengedittombol.

  6. Di bawahBerbagi publikpilihDiaktifkanTombol radio.

  7. Di kotak teks ketik nama aplikasi Anda, lalu pilihSimpantombol.

catatan

Dalam rangka untuk berbagi aplikasi publik, itu harus memiliki keduaSemanticVersiondanLicenseUrlset properti.

Berbagi Aplikasi MelaluiAWS CLI

Untuk berbagi aplikasi menggunakanAWS CLIAnda memberikan izin menggunakanput-application-policyperintah untuk menentukanAWSakun yang ingin Anda bagikan sebagai prinsipal.

Untuk informasi lebih lanjut tentang berbagi aplikasi Anda dengan menggunakanAWSCLI, lihatAWS Serverless Application RepositoryContoh Kebijakan Aplikasi.

Membatalkan Berbagi Aplikasi

Ada dua opsi untuk unsharing aplikasi dariAWSOrganisasi:

  1. Penerbit aplikasi dapat menghapus izin menggunakanput-application-policyperintah.

  2. Seorang pengguna dariakun pengelolaandariAWSOrganisasi dapat melakukanaplikasi unshareoperasi pada setiap aplikasi bersama dengan organisasi, bahkan jika aplikasi itu diterbitkan oleh pengguna dari akun yang berbeda.

    catatan

    Ketika aplikasi tidak dibagikan dariAWSOrganisasi dengan operasi “unshare application”, tidak dapat dibagi denganAWSOrganisasi lagi.

    Untuk informasi selengkapnya tentang AWS Organizations, lihat Panduan Pengguna AWS Organizations.

Publikasi Menghapus Izin

Penerbit Menghapus Izin Melalui Konsol

Untuk unshare aplikasi melaluiAWS Management Console, Anda menghapus pernyataan kebijakan yang berbagi dengan yang lainAWSakun. Untuk melakukannya, ikuti langkah-langkah berikut:

  1. Buka konsol AWS Serverless Application Repository.

  2. PilihAplikasi yang tersediaDi panel navigasi kiri.

  3. Pilih aplikasi yang ingin Anda bagikan.

  4. PilihPembagiantab.

  5. DiPernyataan kebijakan aplikasibagian, pilih pernyataan kebijakan yang berbagi aplikasi dengan akun yang ingin Anda unshare dari.

  6. Pilih Delete (Hapus).

  7. Sebuah pesan konfirmasi akan muncul. PilihHapuslagi.

Penerbit Menghapus Izin MelaluiAWS CLI

Untuk unshare aplikasi melaluiAWS CLI, penerbit dapat menghapus atau mengubah izin menggunakanput-application-policyperintah untuk membuat aplikasi pribadi, atau berbagi dengan set yang berbedaAWSakun.

Untuk informasi lebih lanjut tentang perubahan izin menggunakanAWSCLI, lihatAWS Serverless Application RepositoryContoh Kebijakan Aplikasi.

Akun manajemen unsharing aplikasi

Akun manajemen unsharing aplikasi dariAWSOrganisasi melalui konsol

Untuk membatalkan berbagi aplikasi dariAWSOrganisasi melaluiAWS Management Console, pengguna dariakun pengelolaandapat melakukan hal berikut:

  1. Buka konsol AWS Serverless Application Repository.

  2. PilihAplikasi yang tersediaDi panel navigasi kiri.

  3. Dalam ubin aplikasi, pilihTidak berbagi.

  4. Dalam kotak pesan unshare, konfirmasikan Anda ingin membatalkan berbagi aplikasi dengan memasukkan ID Organisasi dan nama aplikasi, kemudian memilihSimpan.

Akun manajemen unsharing aplikasi dariAWSOrganisasi MelaluiAWS CLI

Untuk membatalkan berbagi aplikasi dariAWSOrganisasi, pengguna dariakun pengelolaandapat menjalankanaws serverlessrepo unshare-applicationperintah.

Perintah berikut unshares aplikasi dariAWSOrganisasi, tempatid aplikasiAmazon Resource Name (ARN), danorganisasi-idadalahAWSID Organisasi:

aws serverlessrepo unshare-application --application-id application-id --organization-id organization-id

Menghapus Aplikasi

Anda dapat menghapus aplikasi dariAWS Serverless Application Repositorydengan menggunakan salah satuAWS Management ConsoleatauAWS SAMCLI.

Menghapus Aplikasi (Konsol)

Untuk menghapus aplikasi yang dipublikasikan melaluiAWS Management Console, lakukan hal berikut.

  1. Buka konsol AWS Serverless Application Repository.

  2. UntukAplikasi saya, pilih aplikasi yang ingin Anda hapus.

  3. Di halaman detail aplikasi, pilihMenghapus aplikasi.

  4. PilihMenghapus aplikasiuntuk menyelesaikan penghapusan.

Menghapus Aplikasi (AWS CLI)

Untuk menghapus aplikasi yang dipublikasikan menggunakanAWS CLI, jalankanaws serverlessrepo delete-applicationperintah.

Perintah berikut akan menghapus aplikasi, tempatapplication-idadalah Amazon Resource Name (ARN) aplikasi:

aws serverlessrepo delete-application --application-id application-id