Nasaďte aplikáciu Meteor na Ubuntu

Tento článok vás prevedie nasadením vašej aplikácie Meteor na Vultr VPS so systémom Ubuntu 14.04. Môže fungovať aj na iných distribúciách Linuxu (pokus na vlastné riziko).

Geniálny chlapík menom Arunoda Susiripala, ktorý je dosť aktívny v komunite Meteor, vyvinul nástroj na nasadenie s názvom mupx (skratka pre „Meteor Up X“), ktorý veľmi uľahčuje nasadenie vašej aplikácie Meteor na vzdialený server cez ssh. Mupx je nástupcom mupu. Prevedieme vás celým procesom od začiatku do konca. Väčšinu zdvíhania ťažkých vecí robí našťastie Mup, takže to bude hračka!

Naším prvým krokom je inštalácia mupx. Urobíte to na svojej vývojovej pracovnej stanici, nie na serveri VPS! Uistite sa, že už máte nainštalovaný Node.js a spustite:

$ npm install -g mupx

Po dokončení inštalácie prejdite do priečinka projektu Meteor, napr /projects/myApp. a spustite nasledujúce príkazy:

$ mkdir .deploy
$ cd $_
$ mupx init

Pre tých, ktorí nie sú oboznámení so $_syntaxou, je to skratka pre posledný argument použitý v príkaze. Takže v tomto prípade sa cd $_vykoná ako cd .deploy.

Uvidíte nasledujúci výstup:

Meteor Up: Production Quality Meteor Deployments
------------------------------------------------
Configuration file : mup.json
Settings file      : settings.json

Empty Project Initialized!

Proces inicializácie vytvorí dva súbory mup.jsona settings.json. Posledný súbor teraz necháme na pokoji. Pokračujte a otvorte sa mup.json. V čase písania tohto článku predvolená hodnota mup.jsonvyzerá takto:

{
  // Server authentication info
  "servers": [
    {
      "host": "hostname",
      "username": "root",
      "password": "password",
      // or pem file (ssh based authentication)
      // WARNING: Keys protected by a passphrase are not supported
      //"pem": "~/.ssh/id_rsa"
      // Also, for non-standard ssh port use this
      //"sshOptions": { "port" : 49154 },
      // server specific environment variables
      "env": {}
    }
  ],

  // Install MongoDB on the server. Does not destroy the local MongoDB on future setups
  "setupMongo": true,

  // Application name (no spaces).
  "appName": "meteor",

  // Location of app (local directory). This can reference '~' as the users home directory.
  // i.e., "app": "~/Meteor/my-app",
  // This is the same as the line below.
  "app": "/path/to/the/app",

  // Configure environment
  // ROOT_URL must be set to your correct domain (https or http)
  "env": {
    "PORT": 80,
    "ROOT_URL": "http://myapp.com"
  },

  // Meteor Up checks if the app comes online just after the deployment.
  // Before mup checks that, it will wait for the number of seconds configured below.
  "deployCheckWaitTime": 15,

  // show a progress bar while uploading. 
  // Make it false when you deploy using a CI box.
  "enableUploadProgressBar": true
}

Aby proces nastavenia fungoval, musíme zmeniť niekoľko vecí.

Najprv sa uistite, že ste nastavili hostsvoju IP adresu VPS, napríklad:

"host": "123.123.123.123",

Ak potrebujete použiť iné číslo portu ako predvolené 22, môžete tak urobiť pomocou sshOptionspoľa, napríklad:

"host": "123.123.123.123",
"sshOptions": { "port": 9876 },

Nastavte usernamehodnotu na ľubovoľného používateľa, ktorému chcete vlastniť inštaláciu vašej aplikácie Meteor. Odporúčam z bezpečnostných dôvodov odstrániť riadok s heslom a namiesto toho použiť kľúč SSH. Odkomentujte riadok s pemhodnotou a uistite sa, že ukazuje na váš tajný kľúč SSH, ktorý zodpovedá verejnému kľúču SSH, ktorý ste nainštalovali na svojom VPS (v /root/.ssh/authorized_keys). Nezabudnite pridať čiarku za riadok s heslom! Ak má váš kľúč SSH pripojenú prístupovú frázu, pemúplne odstráňte riadok a uistite sa, že váš súkromný kľúč SSH je uložený v ssh agentovi (napr. na Macu, ssh-add <path to ssh private key>).

Nechajte setupMongonastavené na predvolenú hodnotu.

Zmeňte appNamenázov aplikácie Meteor. V našom prípade:

"appName": "myApp",

... a tiež nastavte umiestnenie aplikácie vzhľadom na tento priečinok nasadenia:

"app": "..",

Nakoniec nastavte ROOT_URLadresu URL určenú pre vašu aplikáciu. Explicitne nastavte číslo portu na štandardný HTTP port.

// Configure environment
"env": {
  "ROOT_URL": "http://myapp.com",
  "PORT": 80
},

To je všetko! Uložte mup.jsonsúbor a potom spustite:

$ mupx setup

V tomto bode mupx ssh do vášho VPS, nainštaluje Docker, nastaví prostredie a stiahne príslušné obrázky Docker. Teraz nasaďte svoju aplikáciu:

$ mupx deploy

Ak teraz prejdete na http://123.123.123.123, vaša aplikácia sa zobrazí pri načítaní stránky.

Podpora viacerých jadier

Ak má váš VPS viacero jadier, vaša aplikácia Meteor to môže využiť. Budeme musieť urobiť pár rýchlych úprav.

Najprv budete musieť nainštalovať balík klastra. Prejdite do priečinka aplikácie Meteor (v tomto príklade /projects/myApp) a zadajte:

$ meteor add meteorhacks:cluster

Teraz upravte svoj mup.jsonsúbor a upravte sekciu premennej prostredia takto:

// Configure environment
"env": {
  "ROOT_URL": "http://myapp.com",
  "PORT": 80,
  "CLUSTER_WORKERS_COUNT": "auto"
},

Keďže sme do vašej aplikácie pridali nový balík, budete ho musieť znova nasadiť.

$ mupx setup && mupx deploy

Ak by ste niekedy chceli zmeniť premenné prostredia mup.jsonbez toho, aby ste museli nasadiť celú aplikáciu, jednoducho použite príkaz prekonfigurovať. To je užitočné, keď neboli vykonané žiadne zmeny aplikácie.

$ mupx reconfig

Gratulujeme, vaša aplikácia Meteor je teraz spustená! Vaša aplikácia sa tiež automaticky spustí pri každom reštarte VPS. Sledujte budúce články o nasadení a správe Meteoru.