Ha4go を参照してください。
本アプリ及びソースコードの著作権はCode for Kanazawaに帰属します。 但し、このソースコードはMPL 2.0のもと配布されています。MPLに従えば、どなたでも利用、改変、及び再配布が可能です。
本リポジトリの issues 経由でご連絡ください。
本リポジトリをフォークして作業し、デプロイ可能な状態になりましたら GitHub 上から master プルリクエストをください。本リポジトリ運用チームが対応いたします。開発環境の作成は、後述する "ローカル環境での開発環境作成" 及び "heroku での開発環境作成" を参照してください。
様々な団体などに対応できるように Code for Kanazawa 依存の部分はなく、フォーク & 環境変数ですべてカスタム可能なように作ってあります。プルリクエスト時にはこの原則を守っていただけるようお願いします。
| ブランチ名 | 概要 |
|---|---|
master |
デプロイ可能な状態のものです |
release |
Code for Kanazawa 向けにデプロイした際、ここにマージします |
gh-pages |
コードとは独立した Ha4go についてのドキュメント(orphan branch) |
heroku_master |
master へのマージ前にデザイナ確認用ブランチ |
上記以外は各自にまかせます。
下記のツールやサーバに依存しています。各自で準備してください(準備方法は後述してあります)。
- Ruby on Rails 4
- MySQL サーバ
- SMTP サーバ
- Facebook アプリ
$ git clone https://github.com/codeforkanazawa-org/ha4go.git
$ cd ha4go
$ bundle install --path vendor/bundleHa4goをカスタムするデータのいくつかは環境変数を経由して指定します。 dotenv を採用しているので開発には cp .env.sample .env し、内容を変更して使って下さい。現時点では全ての値を設定する必要があります(省略できません、実際に存在するsmtpサーバなどを指定する必要があります)
$ cp .env.sample .env
$ vim .env現時点では以下のデータを用意する必要があります。入力する値は後述する各準備を確認してください。
FACEBOOK_APP_ID=12341234
FACEBOOK_APP_SECRET="hogehogehoge"
DELIVERY_METHOD=letter_opener_web
SMTP_SERVER='smtp.gmail.com'
SMTP_PORT=587
SMTP_DOMAIN='googleapps.domain'
SMTP_USER='[email protected]'
SMTP_PASSWORD='password_of_notifier_user'
APP_HOST=localhost:3000
MYSQL_HOST=127.0.0.1
MYSQL_USER=ha4go
MYSQL_PW=ha4goha4go
USE_HTTPS=0Facebook にテスト用アプリとして登録(OAuth認証のため登録必須)してください。
Facebook Developers https://developers.facebook.com/
- メニュー > My Apps > Add a New App
- 種別の中から、「ウェブサイト(www)」を選択
- アプリの名前を入力(ha4go-devなど)
- カテゴリを適当に選択してCreate App ID でID発行
- Quick Startとしてコードが出てくるが、ここは飛ばして以下を入力してNext
- "Tell us about your website"
- Site URL:
http://localhost:3000/ - Mobile Site URL:
http://localhost:3000/
- メニュー > My Appsに3で入力したアプリ名が出るのでそこからダッシュボードへ
- "App ID" と "App Secret"を控えておいて、
.envや 環境変数で用いて下さい
FACEBOOK_APP_ID={App ID}"
FACEBOOK_APP_SECRET={App Secret}nginxなどのリバースプロキシを使い、ローカル以外にデプロイしてHTTPSを用いる場合、
USE_HTTPS=1
としてください。内部的にリンクを作成する際、 https:// が採用されるようになります。
DELIVERY_METHOD= でメール送信方法を選択します。
開発時には letter_opener_web が指定できます。これを指定するとメールは送信されず、サーバの用意も必要ありません。加えて http://localhost:3000/letter_opener で擬似的に送信したメールを確認することができます(開発時のみ有効なURLです)。この場合は SMTP_ からはじまる全ての環境変数は無視されます。
運用配置など実メールを用いる場合には smtp を指定して、メールサーバを用意してください。Gmailがそのまま使えるので、アカウントを取得して設定すると楽です。(Gmailの場合の SMTP_DOMAINは smtp.gmail.com です)
DELIVERY_METHOD=smtp
現在、環境が production だろうが development だろうが、MySQL を用いています。以下の3つの方法から、好きなものを使って下さい。
MySQLをインストールし、 init.sql を参考にして db と Ha4go用ユーザーを 作成してください。下記は OSX で一番簡単な例です。
mysql.server start # start mysql
mysql -uroot -p < init.sql # create db & user
export MYSQL_HOST=localhost # (or edit .env)
bundle exec rake db:setup # setup databaseMySQLをビルドし、用います。 docker-machine などを用いている場合、リモートホストの接続制限でユーザ root でアクセスできません。
注意このMySQLは公式Dockerのrootパスワードそのままなど安全ではないですので運用には充分気をつけて下さい
bundle exec rake -f Rakefile.deploy build[db] # image build
bundle exec rake -f Rakefile.deploy run[db,DEBUG] # start mysql
export MYSQL_HOST=`docker-machine ip default` # docker-machineの場合、Linuxの場合は 127.0.0.1 など
mysql -uroot -h$MYSQL_HOST -p < init.sql # create db & user
bundle exec rake db:setup以後は bundle exec rake -f Rakefile.deploy run[db,DEBUG] で開始できます。
後述するアプリの起動で同時に行えます。
bundle exec rails s
その後、ブラウザで http://localhost:3000 で画面が見えれば成功。メール送信・SNSへポストなど非同期実行するものは以下のコマンドでActive Jobを動かしてください。
bundle exec rake jobs:work
開発をスムーズにするため、db/seeds/モデル名.yml.sample に記述されているダミーデータを開発用に利用することができます。
以下のコマンドからダミーデータを入れることが可能です。
bundle exec rake db:seed:unlock_yml
bundle exec rake db:seed
ha4go は Facebook ログインを利用しているため、 uid はその Facebook が払い出したIDを本来用いないといけませんが、db/seeds/users.yml.sample ではダミーの値を用いてます。この値を使っても Facebook と連携はとれません。
(現在準備中、後述する docker-compose を使うことをお薦めします)
docker-compose を使うと、db と web 両方の環境を立ち上げてくれます.env ファイルは MYSQL_HOST=db としておいてください。
注意このMySQLは公式Dockerのrootパスワードそのままなど安全ではないですので運用には充分気をつけて下さい
eval $(docker-machine env) # docker-machineを用いている場合
docker-compose build
docker-compose up
export MYSQL_HOST=`docker-machine ip default` # docker-machineの場合、Linuxの場合は 127.0.0.1 など
mysql -uroot -h$MYSQL_HOST -p < init.sql # create db & userdb の初期設定は以下の手順で行ってください。
docker-compose run --rm web bundle exec rake db:setup # dbの作成, migrate, seed の投入この状態で、docker-machine ip:3000 にブラウザでアクセスするとページが見れるようになります。
基本的に、rails コマンドなど他のものを実行したい場合も、上記のようにdocker-compose run --rm web bundle execの後につければ実行できます。
できます! 3306ポートをマッピングしてありますので、docker-machine ip で取得できるIPアドレスの3306番にアクセスしてください。
docker-compose up を実行しているプロセスを、Ctrl+C で止めて、再度 docker-compose up を実行してください。
macOS を前提として書いています。おそらく Ubuntu などでもできると思います。
アカウント取得し、CLIツールのインストールを行ってください。
Heroku Command Line | Heroku Dev Center
heroku version で問題なくツールのバージョンを取得できることを確認してください。
$ git clone https://github.com/codeforkanazawa-org/ha4go.git
$ cd ha4go
$ bundle install --path vendor/bundleclone したディレクトリに移り、アプリ作成、DB設定など下記の用に行います
$ cd ha4go # 前述の bundle install した ディレクトリです
$ heroku create
$ heroku config | grep CLEARDB_DATABASE_URL # これで mysql://.+ を確認
$ heroku config:set DATABASE_URL=mysql2://(上の.+の値を用いる)前述した ローカル環境へのインストール手順 の .env ファイルの準備 で指定する内容を準備して設定します。
不必要なものもあるので、下記の内容のみを各自の用意した値で行ってください。
$ heroku config:set FACEBOOK_APP_ID=12341234
$ heroku config:set FACEBOOK_APP_SECRET=hogehogehoge
$ heroku config:set SMTP_SERVER=smtp.gmail.com
$ heroku config:set SMTP_PORT=587
$ heroku config:set SMTP_DOMAIN=googleapps.domain
$ heroku config:set [email protected]
$ heroku config:set SMTP_PASSWORD=password_of_notifier_user
$ heroku config:set DELIVERY_METHOD=smtp$ git push heroku # デプロイ
$ heroku run rake db:setup # データベースマイグレーション & 初期値の設定
$ heroku open # ブラウザで開いてみる
$ heroku logs # ログの確認
$ heroku run rake db:migrate # 以降イテレーション時に必要あれば同ディレクトリで git push heroku をすればデプロイされます。データベースのマイグレーションや初期データの設定を行う必要がある場合(最初のデプロイ時には必ず必要です)には heroku run rake db:setup を同ディレクトリで行ってください。
その場合、
- 画像保存で利用するファイルストレージの設定（デフォルトではAmazon S3を指定しています）
- メール配信サービスの設定（デフォルトではSendGridを指定しています。設定方法）
- データベースの設定
が必要になります。
運用時にはSSL証明書を用いることを強く推奨します。
<団体名>.ha4go.net で運用したい場合にはDNSを設定しますのでIssues · codeforkanazawa-org/ha4go経由で下記を明記の上連絡ください。確認でき次第設定いたします。
- 団体名と連絡先
- 設定したい団体名(
<団体名>.ha4go.netとなります) - IPアドレスもしくはCNAME
SSL証明書については *.ha4go.net をEV証明書を取得して運用して おりません ので、各自で運用したい <団体名>.ha4go.net の証明書を取得・運用してください。