Heroku クイックスタート

ステップ 1: サインアップする

まず、Heroku.com に移動して [サインアップ] をクリックし、無料の Heroku アカウントを取得します。無料のアカウントと共に、開始するための無料の dyno 時間を得られます。

ステップ 2: Heroku Toolbelt をインストールする

Heroku Toolbelt には、Heroku クライアント (Heroku アプリケーションを作成および管理するためのコマンドラインツール)、Foreman (アプリケーションをローカルで実行するための簡単なオプション)、および Git (Heroku にアプリケーションを転送するために必要なリビジョン管理システム) が含まれています。

Heroku Toolbelt には、スタンドアロンパッケージのほかに、Mac OS X、Windows、および Debian/Ubuntu 用のパッケージが用意されています。

ステップ 3: コマンドラインからログインする

Toolbelt をインストールしたら、コマンドシェルから heroku コマンドにアクセスできます。

Heroku アカウントの作成時に使用したメールアドレスとパスワードを使用して認証します。以前にキーを Heroku にアップロードしている場合、そのキーを使用し続けると想定されるため、ログイン中に新しいキーを作成するように求められることはありません。

プロンプトで Enter キーを押して、既存の ssh キーをアップロードするか、新しいキーを作成します。このキーは、後でコードを転送するときに使用します。

ログイン後に新しいキーを作成してアップロードする場合、単に heroku keys:add を実行します。

ステップ 4: アプリケーションのリリースの準備をする

これで、Heroku にアプリケーションをリリースする準備が整いました。既存のアプリケーションがない場合、オンラインの開発センターにある「Hello World!」サンプルを利用できます。

Heroku は、Gemfile が存在していれば、アプリケーションが Ruby で記述されていると判断します。Heroku が、pom.xml ファイル (Java)、requirements.txt (Python)、および package.json (Node.js) を検索します。

アプリケーションを Heroku にリリースする前に、あといくつかの作業 (連動関係の宣言、プロセスタイプの宣言、ローカルでのアプリケーションのテスト、Git へのコードのコミット) を行う必要があります。

まず、連動関係 (システムレベルの連動関係は除く) を宣言する必要があります。アプリケーションをローカルでテストし、アプリケーションと連動するすべての gem が Gemfile にあることを確認します。使用する Ruby のバージョンを忘れずに指定してください。Heroku では、デフォルトで Ruby 2.0 がサポートされていますが、整合性を確保するためにすべてのアプリケーションでバージョンを指定する必要があります。

次に、Procfile でプロセスタイプを宣言する必要があります。Procfile は、dyno を起動するために実行する必要のあるコマンドを明示的に宣言するテキストファイルで、アプリケーションのルートにあります。このファイルには、web、worker、またはその他のプロセスが含まれます。この例では、web dyno を開始します。

これは、単一プロセスタイプ web と、web を実行するために必要なコマンドを宣言しています。ここでは、「web」という名前が重要です。これは、このプロセスタイプが Heroku の HTTP ルーティングスタックに関連付けられ、リリース時に Web トラフィックを受信することを宣言しています。

この時点で、Foreman (Procfile 対応アプリケーションを実行するためのコマンドラインツール) を使用して、ローカルでアプリケーションを実行できます。Foreman は、Heroku Toolbelt と共にインストールされています。

foreman start を実行するだけでポート 5000 でアプリケーションが起動されるため、確認します。

最後に、アプリケーションファイルをローカルの Git リポジトリにコミットします。

ステップ 5: リリースする

これで、Heroku にアプリケーションをリリースする準備が整いました (負荷の高い作業は完了しました)。

まず、heroku create コマンドを使用して Heroku にアプリケーションを作成します。

次に、git push heroku master コマンドを使用して、Git でアプリケーションをリリースします。

この例では、http://blazing-galaxy-997.herokuapp.com で Web ブラウザにアプリケーションを表示したり、curl を使用してテストしたりできるようになります。

これで、最初のアプリケーションを Heroku にリリースできました。

ステップ 6: CLI を使用する

Heroku CLI を使用して、アプリケーションの操作 (統合ログの表示、アプリケーションの拡張、アドオンサービスの追加) を行うことができます。  

Web トラフィックをスケールアップする場合、web dyno の数を調整するように Heroku に通知するだけですみます。

実行されている dyno の数を確認します。

発生したすべての新規ログイベントが表示されるように tail を指定して、統合ログストリームを表示します。

重大なイベントに関するログを保持してアラートを送信する必要がある場合、多数のログ記録アドオン (Papertrail など) のいずれかを追加します。

効率性と生産性の高い開発者ワークフローを設定する必要がある場合、Heroku では、アプリケーション全体に fork を実行できるため、同一のステージング環境を簡単に構築できます。

これで、ソースの新しいブランチをこの新規アプリケーションにリリースできます。

カスタムドメインで起動する準備はできましたか。DNS および CNAME を設定すれば、簡単に実行できます。

Heroku では、設定とコードが分離されているため、アプリケーションに影響する可能性のある値 (秘密鍵など) を簡単に変更できます。

リリース履歴にドリルダウンして、ベロシティ、最新の変更、またはトラブルシューティングの問題に関する詳細情報を取得する必要がある場合、これに対応するコマンドも用意されています。

問題を修正するために以前のリリースにロールバックします。