CloudControl adalah platform cloud seperti Heroku. Membuat add-on cloudControl sangat mirip dengan membuat add-on Heroku tetapi ada beberapa perbedaan. Artikel ini menjelaskan perbedaan tersebut.

Perkenalan

Add-on GroupDocs untuk cloudControl adalah alat web yang dapat diinstal pada aplikasi web apa pun untuk menyediakan fungsionalitas GroupDocs:

  • Buat pengguna GroupDocs baru dengan paket gratis dan dapatkan ID pengguna dan kunci pribadi untuk pengguna ini. Ini dilakukan secara otomatis saat add-on diinstal.
  • Pengguna dapat mengubah paket pembayaran menggunakan fungsi ubah paket add-on.
  • Akses ke metode apa pun dari GroupDocs API menggunakan ID klien dan kunci pribadi (yang bisa Anda dapatkan dari add-on). Kami membuat contoh ini yang menunjukkan cara menggunakan add-on dan GroupDocs Python SDK untuk beberapa tindakan dasar.

Persyaratan

  • Alat kensa
  • alat cloudControl
  • Python 2.7
  • aplikasi cloudControl

Membuat Pengaya

Proses pembuatan add-on cloudControl sama dengan membuat add-on Heroku, tetapi, seperti yang saya katakan sebelumnya, dengan beberapa perbedaan. Kami tidak akan membahas cara membuat add-on karena Heroku memiliki banyak dokumentasi untuk ini dan Anda memutuskan bagaimana Anda membuatnya. Saya hanya akan menunjukkan apa sebenarnya perbedaannya. Mari kita asumsikan bahwa kita sudah memiliki add-on Heroku yang keren dan ingin membangunnya kembali untuk cloudControl:

  1. Instal alat Kensa dan cloudControl. Mereka membantu Anda mengelola aplikasi add-on dan cloudControl. Cari tahu cara memasang alat cloudControl.
  2. Setelah menginstal alat, ubah file addon-manifest.json. Ini berisi semua informasi dasar untuk penginstalan add-on, seperti variabel lingkungan mana yang akan dibuat dan dari mana mendownload dan menginstal file add-on.
    • Sebelum Anda mengunggah file addon-manifest.json yang telah diedit, setel variabel lingkungan ADDONS\URL=https://api.cloudcontrol.com:.
    • Tentukan server produksi. Heroku meminta Anda untuk menentukan server produksi, dan kemudian membuat URL yang digunakan untuk menyediakan add-on Anda dengan menambahkan “/heroku/resources” ke dalamnya. Sekarang, berikan hash alih-alih string dan ubah “/heroku/resources” menjadi “/cloudcontrol/resources”.
    • Tambahkan “sso\salt”:“PASSWORD” dan “production”: {“base\url”:“https://your.add-on.com/cloudcontrol/resources", “sso\url”:“https:/ /your.add-on.com/cloudcontrol/resources”}.
  3. Ubah “heroku\id” menjadi “cloudcontrol\id” di file add-on.
  4. Saat perubahan telah dilakukan, uji add-on dengan uji Kensa dengan menjalankannya di konsol: penyediaan uji kensa dan uji deprovisi kensa. [caption id=“lampiran\3488” align=“alignnone” width=“600” caption=“Tes Kensa”]
  5. Jika tes lulus, dorong addon-manifest.json ke cloudControl dengan kensa push -f addon-manifest.json. [caption id=“attachment\3489” align=“alignnone” width=“600” caption=“Kensa push”]
  6. Instal add-on ke aplikasi cloudControl Anda: cctrlapp YOUR\APP\NAME addon.add YOUR\ADDON\NAME.PLANE

Sekarang kami telah menerbitkan add-on cloudControl dan menginstalnya. Sejauh ini bagus. Bagaimana kita mendapatkan variabel lingkungan yang dibuat oleh add-on? Ayo cari tahu.

Cara Mendapatkan Variabel Lingkungan

Di Heroku, ini mudah. Misalnya, di Python kita bisa melakukan ini dengan baris os.environ[‘VARIABLE NAME’]. Jika Anda mencoba ini di cloudControl, Anda hanya mendapatkan beberapa properti dasar Python dan bukan variabel add-on Anda. Di cloudControl, semua variabel lingkungan yang dibuat oleh add-on ditulis ke file json yang bisa kita dapatkan dengan menggunakan CRED\FILE. Ini adalah nama properti sistem yang berisi jalur ke file JSON dengan variabel lingkungan. Untuk mendapatkan data kami, yang kami butuhkan hanyalah membaca file JSON ini dan mendekode string JSON. Di Python, kita bisa melakukan ini dengan kode ini:

credentialsFile = os.getenv('CRED\_FILE')
    credentials = open(credentialsFile)
    data = json.load(credentials)
    credentials.close()
    clientId = data\['GROUPDOCS'\]\['GROUPDOCS\_CID'\]
    privateKey = data\['GROUPDOCS'\]\['GROUPDOCS\_PKEY'\]

Begitulah cara kami mendapatkan ID klien dan kunci pribadi dari pengguna add-on GroupDocs. Dan itu saja. Anda sekarang tahu apa perbedaan antara add-on Heroku dan cloudControl.