CloudControl je cloudová platforma podobně jako Heroku. Vytvoření doplňku cloudControl je velmi podobné vytvoření doplňku Heroku, ale existují určité rozdíly. Tento článek vysvětluje tyto rozdíly.

Úvod

Doplněk GroupDocs pro cloudControl je webový nástroj, který lze nainstalovat do libovolné webové aplikace a poskytovat funkce GroupDocs:

  • Vytvořte nového uživatele GroupDocs s bezplatným plánem a získejte pro tohoto uživatele ID uživatele a soukromý klíč. To se provádí automaticky při instalaci doplňku.
  • Uživatel může změnit platební plán pomocí funkce změny plánu doplňku.
  • Přístup k jakýmkoliv metodám z GroupDocs API pomocí ID klienta a soukromého klíče (které můžete získat z doplňku). Vytvořili jsme tento příklad, který ukazuje, jak používat doplněk a GroupDocs Python SDK pro některé základní akce.

Požadavky

  • Nástroj Kensa
  • nástroj cloudControl
  • Python 2.7
  • aplikace cloudControl

Vytvoření doplňku

Proces vytvoření doplňku cloudControl je stejný jako u vytvoření doplňku Heroku, ale jak jsem již řekl dříve, s několika rozdíly. Nebudeme se zabývat tím, jak doplněk vytvořit, protože Heroku má k tomu spoustu dokumentace a vy se rozhodnete, jak jej vytvoříte. Jen ukážu, jaké přesně jsou rozdíly. Předpokládejme, že již máme skvělý doplněk Heroku a chceme jej přestavět pro cloudControl:

  1. Nainstalujte nástroje Kensa a cloudControl. Pomáhají vám spravovat doplňkové aplikace a aplikace cloudControl. Zjistěte, jak nainstalovat nástroj cloudControl.
  2. Po instalaci nástrojů změňte soubor addon-manifest.json. Obsahuje všechny základní informace pro instalaci doplňku, například jaké proměnné prostředí budou vytvořeny a odkud stahovat a instalovat soubory doplňků.
    • Než nahrajete upravený soubor addon-manifest.json, nastavte proměnnou prostředí ADDONS\URL=https://api.cloudcontrol.com:.
    • Zadejte produkční server. Heroku vyžadovalo, abyste uvedli produkční server, a poté vytvořili adresu URL použitou k poskytování vašeho doplňku přidáním „/heroku/resources“. Nyní zadejte hash místo řetězce a změňte “/heroku/resources” na “/cloudcontrol/resources”.
    • Přidejte “sso\salt”:“HESLO” a “production”: {“base\url”:“https://vas.add-on.com/cloudcontrol/resources", “sso\url”:“https:/ /your.add-on.com/cloudcontrol/resources”}.
  3. Změňte “heroku\id” na “cloudcontrol\id” v souborech doplňků.
  4. Po provedení změn otestujte doplněk pomocí testů Kensa spuštěním v konzole: zřízení testu kensa a test deprovision kensa. [caption id=“attachment\3488” align=“alignnone” width=“600” caption=“Testy Kensa”]
  5. Pokud testy projdou, odešlete addon-manifest.json do cloudControl pomocí kensa push -f addon-manifest.json. [caption id=“attachment\3489” align=“alignnone” width=“600” caption=“Kensa push”]
  6. Nainstalujte si doplněk do své aplikace cloudControl: cctrlapp YOUR\APP\NAME addon.add YOUR\ADDON\NAME.PLANE

Nyní jsme zveřejnili a nainstalovali doplněk cloudControl. Zatím je vše dobré. Jak získáme proměnné prostředí, které doplněk vytváří? Pojďme to zjistit.

Jak získat proměnné prostředí

V Heroku je to snadné. Například v Pythonu to můžeme udělat pomocí řádku os.environ[‘NÁZEV PROMĚNNÉ’]. Pokud to vyzkoušíte v cloudControl, získáte pouze několik základních vlastností Pythonu a ne vaše doplňkové proměnné. V cloudControl jsou všechny proměnné prostředí vytvořené doplňkem zapsány do souboru json, který můžeme získat pomocí CRED\FILE. Toto je název systémové vlastnosti, která obsahuje cestu k souboru JSON s proměnnými prostředí. Abychom získali naše data, vše, co potřebujeme, je přečíst tento soubor JSON a dekódovat řetězec JSON. V Pythonu to můžeme udělat pomocí tohoto kódu:

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

Takto získáme ID klienta a soukromý klíč uživatele doplňku GroupDocs. A to je vše. Nyní víte, jaký je rozdíl mezi doplňky Heroku a cloudControl.