Linux環境上にAnsibleをインストールし、Playbookを実行できる状態にする。
Linuxの稼働環境を用意し、シェルに接続する。 Vagrant を使うと、以下の手順で簡単にUbuntu 16.04環境を作ってログインすることが可能です。
mkdir ansible-handson; cd $_
vagrant init bento/ubuntu-16.04
vagrant up
vagrant sshログイン後は、ホストOSとファイルを共有できるように /vagrant ディレクトリに移動し、日本語が文字化けしないように対応を実行します。
cd /vagrant
unset LANGUAGE
まずは、以下の手順でGitをインストールしましょう。
sudo apt-get update && sudo apt-get install -y gitsudo yum install -y git次に、インストールした git コマンドを使ってリポジトリをクローンし、ディレクトリを移動します。
git clone https://github.com/h-hirokawa/azure-mastodon-playbook.git
cd azure-mastodon-playbookリポジトリに含まれている install_ansible.sh スクリプトを使ってAnsibleをインストールしましょう。これを用いると必要な依存関係も含めてAnsibleをインストールすることができます。
./install_ansible.sh中で sudo を実行しているので、パスワードを聞かれた場合は手で入力してください。
ansible --versionを実行してAnsibleのバージョンが表示されればインストールは成功です。
今回のPlaybookでは各種ミドルウェア(Nginx, Postgresql, Redis)と言語環境(Ruby, Node.js)のセットアップに公式Role共有ポータル Ansible Galaxy で公開されていRoleを使っています。 必要なRoleの依存情報は requirements.yml に記述されており、このファイルを使って以下のようにコマンド一発でダウンロードすることができます。
ansible-galaxy install -r ./requirements.ymlこれでPlaybook実行のためのAnsible側の準備は整いました。
次にPlaybookからAzureを操作する際に必要となる、Python製コマンドラインツール Azure CLI 2.0 をセットアップしていきます。
Ansibleではローカル環境の操作も行えるため、このAzure CLIのインストール手順もPlaybook化しています。 以下のようにPlaybookを走らせてみましょう。
ansible-playbook ./site.ymlsudo 実行にパスワードが必要な環境の場合は、 -K オプションをつけると、
ansible-playbook -K ./site.yml以下のようなプロンプトが表示されますので、パスワードを入力してください。
SUDO password:
ちなみに、今回のPlaybookはAzure CLIのインストールが完了した時点で実行失敗となってしまいますが、これは想定通りの動きです。 そのまま先に進んでいきましょう。
上段のPlaybook実行時の出力を見ると、下の方に以下のような部分が見つけられます
TASK [azure_vm : debug] *****************************************************************************************************************************
ok: [localhost] => {
"msg": [
"Service Principle情報が存在しません、以下の3コマンドを順に実行してからPlaybookを再実行してください。",
"source ~/venv/azure-cli/bin/activate",
"az login",
"az ad sp create-for-rbac -n http://ansible-demo --role contributor > /vagrant/azure-mastodon-playbook/resources/azure-sp.json"
]
}
出力されているメッセージ通り、Service Principal（アプリケーションからAzureを操作するための認証ID的なもの、参考資料）がAzure AD上に未登録であるためのエラーです。 Service Principle作成のためには、Azure CLIから各ユーザー・アカウントでログインする必要があるのですが、このログインの際にブラウザ経由の処理が必要となってしまうため、ここでは一旦Playbook実行を中断し、手動対応が必要な手順を案内するようにしています。
まず、一つ目のコマンドを実行しましょう。
source ~/venv/azure-cli/bin/activateAzure CLIはVirtualenvという仕組みを使って、ホスト上のグローバルなPython環境とは隔離したスペースにインストールされていますが、上記のコマンドでそのVirtualenv環境の中に入ることができます。
次にログイン処理です。
az loginコマンドを実行すると、
To sign in, use a web browser to open the page https://aka.ms/devicelogin and enter the code XXXXXXXXX to authenticate.
というような表示が出てきますので、ブラウザから https://aka.ms/devicelogin にアクセスし、認証コード（GRMJ4GLQ6 の部分）を入力し、「続行」ボタンをクリックしてください。
そこから先は、通常のAzureログイン時と同じ流れでシステムにログインすることでCLIからあなたのアカウント権限でAzureを操作することができるようになります。
最後に、
az ad sp create-for-rbac -n http://ansible-demo --role contributor > /vagrant/azure-mastodon-playbook/resources/azure-sp.json（http://ansible-demo の部分はADごとにURL形式にさえなっていれば、実在しないURLでも問題ありません）
を実行して、Service Principleを作成すればここでの対応は完了です。
Service Principleの利用に必要なIDやパスワードは /vagrant/azure-mastodon-playbook/resources/azure-sp.json に保存され、Playbookから読み取り可能になっています。
Service Principleの設定が済んでしまえば、あとはVM作成からVM内のセットアップまで、全てPlaybookが実行してくれます。 先ほどと同じように
ansible-playbook ./site.ymlを実行して、デプロイ完了までしばらく待ちましょう。
デプロイ完了までにはある程度の時間がかかるので、その間にMastodonからメールを送信できるようにしていきましょう。 Azureではセキュリティの観点からVM上から直接メールを送信することができませんので、Azure上から簡単に無料アカウントを発行できるSendGridを使ってメールを送信できるようにしてみます。
詳細手順: https://docs.microsoft.com/ja-jp/azure/app-service-web/sendgrid-dotnet-how-to-send-email
ブラウザでAzure Portal を開き、左メニューバー上部の「+」ボタンをクリック、検索ウィンドウに "SendGrid" と入力、「SendGrid Email Delivery」リソースを作成してください。 特に決まりはありませんが、名前は「MySendGrid」、リソースグループは新規作成で「SendGrid」などが良いでしょう。 Pricing tierは無料の「F1」を選択してください。
リソースが作成できたら、ポータル画面から「MySendGrid」を開き、「すべての設定」→「Configurations」内の USERNAME をコピーしましょう。
次に、 https://app.sendgrid.com/login を開き、コピーした USERNAME とリソース作成時に入力したパスワードでログインします
SendGridのダッシュボードに入ったら、左メニューバー下部の「Settings」→「API Keys」をクリックし、API Keys画面へ遷移、右上の「Create API Key」をクリックしましょう。
APIキー作成画面では、API Key Nameは「MastodonDemo」と入力、API Key Permissions は「Restricted Access」を選択し、「Mail Send」のバーの右端をクリックし「Full Access」状態にします。
ここで「Create & View」をクリックすると、作成完了画面にAPIキーが表示されます。
このAPIキーをコピーして、site.yml 中の68行目、###ここにAPIキーをペーストする### の部分に貼り付けましょう。
# 以下、ハンズオン用SMTPサーバ情報。
mastodon_smtp_server: smtp.sendgrid.net
mastodon_smtp_login: apikey
mastodon_smtp_password: ###ここにAPIキーをペーストする###ここまでの作業が完了したら、一旦、Playbook実行完了まで待ちましょう。
Playbook実行完了時点でMastodonは起動状態になっていますが、mastodon_smtp_password の設定がまだ反映されていない状態ですので、最後にもう一度Playbookを実行します。
ansible-playbook --tags=mastodon ./site.yml--tags に mastodon と指定すると、ミドルウェア系のセットアップをスキップし、短時間でPlaybookの実行を完了させることができます。
デプロイが正常に完了すると、実行ログの終わりに以下のようなメッセージが表示されます。
TASK [サイト情報を表示] *****************************************************************************************************************************
ok: [localhost] => {
"msg": [
"デプロイが完了しました。",
"ブラウザから http://xx.xx.xx.xx にアクセスしてみましょう"
]
}
http://xx.xx.xx.xx の部分は各自のVMに自動で紐づけられた公開IPアドレスになります。
最後に、Mastodonインスタンスが表示されユーザー登録とログインができることを確認したら、ハンズオンは完了です！