nakatievent commented 3 years ago

今回ポートフォリオを作成するにあたってAWS、Docker、Laravelを使用することになった。

Laravelに関してはRailsを使った経験があればすぐに慣れると想定しているが、他の2つについては正直全然知識がない状態である。

そこで、色々と検索したりYoutube動画とかを見ていたところ山浦清人さんのYoutube動画が分かりやすそうだったのでこの動画を中心に勉強することにした。

「習うより慣れろ」

この精神でやっていくしかない！

nakatievent commented 3 years ago

【Docker超入門】Dockerって何？何が良いの？

Dockerとは

開発環境を簡単に作るツール
アプリを簡単に開発・デプロイできる仕組み
OS、ライブラリ、アプリケーションがひとまとめになっているパッケージ
テスト環境でも本番環境でも入れるだけ
メンバー間の開発環境の統一が可能
Web系だとスタンダードな技術
Git、Linux、CI/CDは現場では必須

nakatievent commented 3 years ago

【Docker超入門】環境構築 for Mac

必要なアプリケーション

VScode
Docker
iTerm2
Git

nakatievent commented 3 years ago

【Docker超入門 #3】Linuxの基本コマンド

LinuxとはOSの一つ（OSとはコンピュータを動かすための基本ソフトのこと。WebサービスはLinux上で開発するのが主流））
Dockerは環境開発を整えるものでOSからコードまでをひとまとめにしたもの。Dockerを使う時もOSはLinuxを使っているからLinuxを操作できないと開発できない。
シェルはLinuxのコマンドを受け取って結果を出力するためのソフトウェア
コマンドを入力したら、シェルが命令を解釈してLinuxに伝えて、Linuxがコマンドを実行し、シェルがコマンドの実行結果をユーザーに伝える。
コマンドを入力する画面がターミナルで。ターミナルが入出力の画面を提供するソフトウェアで、ターミナルの中でシェルが動いている。

コマンド一覧

ls（ディレクトリの中のファイルを表示）
pwd（現在いるディレクトリを表示）
cd（移動）
mkdir（ディレクトリを作る）
touch（ファイルを作る）
echo（ファイルに書き込む）
cat（ファイルの中身を表示する）
less（ファイルの中身を表示する）
mv（ファイルの位置を変えたり、ファイルの名前を変えたりする）
rm（ファイルを削除する）

nakatievent commented 3 years ago

【Docker超入門】Dockerを使ってみよう

docker run hello-world
イメージ（OS・アプリコード）からコンテナ（Dockerの実行環境）を作成し、起動する。イメージはコンテナに必要な事項を記載したひな形。
docker run（クライアント）がデーモン（クライアントが実行したコマンドを受け取ってイメージやコンテナを操作するアプリケーション）にタスクを実行するように伝える。伝えたらHello-WorldというイメージをDockerレジストリが取得（イメージをオンライン上に保存するのがDockerレジストリ）。取得したイメージからコンテナを作成して起動させる。
処理の流れをまとめると、ターミナルでコマンドを実行する。次にDockerクライアントが命令をデーモンに伝える。イメージをレジストリから取得する。取得したらそのイメージからコンテナを作成し、コンテナを起動する。

nakatievent commented 3 years ago

【Docker超入門 #5】アプリを作成・実行しよう

アプリケーションコード・Dockerfile　→　イメージ、作成・起動　→　コンテナ
Dockerfileはイメージのひな形。Dockerfileの内容を元にDockerのイメージを作る。
RUNはコマンドの実行。
イメージを作るコマンド→docker image build -t sample/webrick:latest .（dockerのイメージを作る。-t 〇〇はタグの名前。.は今いるディレクトリのdockerfileを参照する）
イメージを作れたかどうかの確認→docker image ls
dockerのコマンド一覧を確認する→　docker --help
docker container run -p 8000:8000 --name webrick sample/webrick:latest→（コンテナの作成と起動 -pはポートの指定 --nameはイメージの名前）
↑localhost:8000でアクセスすると出る。

①コンテナのライフサイクル

コンテナのサイクルには、作成→起動→停止→削除 という一連の流れがあり、それを元に実行していく。

docker container ls　→コンテナの起動状態を確認する
docker container ls -a　→全部のコンテナを出す
docker container stop 〇〇　→〇〇というコンテナを停止させる
docker container rm 〇〇　→〇〇というコンテナを削除する

＊コントロール＋Cで停止する

②コンテナの操作でよく使う操作として、①ログ、②コマンド実行、③お掃除がある

docker container logs 〇〇　→ログを確認する
docker container exec webrick ruby -v　→〇〇というコマンドを実行
docker system prune -a　→使わないイメージやコンテナを一気に消す

nakatievent commented 3 years ago

【Docker超入門 #6】Dockerfileを作成しよう

Dockerfile　→イメージのひな型
FROM ruby:2.7　→バージョンの指定
WORKDIR /var/www　→作業するディレクトリの位置　どんな作業をするかを記載。
COPY ./src /var/www　→ソースコードをコピーする（アプリケーションソースコードをDockerにコピーできる）
RUN bundle config --local set path 'vendor/bundle' \ && bundle install　→Dockerファイルに反映させる
CMD ["bundle", "exec", "ruby", "app.rb"]　→Dockerを実行するコマンド（サーバーが立ち上がる）
docker container run -it -p 4567:4567 --name sinatra -v ${PWD}/src:/var/www sample/sinatra:latest
-it　→イントラクティブなプログラムを実行する（bashと接続する）
-p　→ポート番号
-v ${PWD}/src:/var/www　→ソースコードの共有（ローカルでコードを修正したらDocker側でも修正される。開発が楽になる）
root@54674c555782:/var/www#　→bashが起動してcat gemfileとかでコードを見れたりする
bundle config --local set path ‘vendor/bundle’ →ライブラリーをインストールするディレクトリを指定する
bundle install→
bundle exec ruby app.rb　→Gemfileを使った処理を動かす

nakatievent commented 3 years ago

【Docker超入門 #7】Docker ComposeでRailsを構築しよう

docker-compose.yml　→複数アプリケーション（複数コンテナを一括で管理）をまとめて操作する。

基本操作

・イメージのビルド　docker-compose build ・コンテナの作成と起動　docker-compose up -d ・コンテナを停止・削除　docker-compose down ・コンテナの一覧を表示　docker-compose ps ・ログを表示　docker-compose logs ・コンテナを作成してコマンド実行　docker-compose run <サービス> <コマンド> ・起動中のコンテナにコマンド実行　docker-compose exec <サービス> <コマンド>

全体の流れ

Docker関連のファイルを用意
初期設定
起動
追加操作

version: '3'
services:
 db:
   image: mysql:8.0
   command: --default-authentication-plugin=mysql_native_password
   volumes:
     - ./src/db/mysql_data:/var/lib/mysql
   environment:
     MYSQL_ROOT_PASSWORD: password
 web:
   build: .
　　↑今のディレクトリと同じディレクトリのrubyのDockerfileを使うという設定
   command: bundle exec rails s -p 3000 -b '0.0.0.0'
   ↑rails serverを起動している
   volumes:
     - ./src:/app
　　src以下をDockerコンテナ内のappに共有する。ローカルのファイルを更新したら自動的にdockerに更新される
   ports:
     - "3000:3000"
   environment:
     RAILS_ENV: development
   depends_on:
     - db

docker-compose run web rails new . --force --database=mysql　→ウェブサービス（rails）に対して実行する。
--force --database=mysqlはデータベースはmysqlを使用しますよという意味。
docker-compose-build　→dockerfileやGemが更新されるともう一回イメージをビルドする
docker-compose up　→ビルドからの起動
docker-compose run web rails db:create　→ウェブの方にデータベースの作成

nakatievent commented 3 years ago

【Docker超入門】本番環境に公開しよう

ローカルだけだともったいない。本番環境でこそ真価を発揮する。
サーバーに対して手動でライブラリをいれるので面倒だし、本番とローカルの差異が生じる。思わぬエラーが発生する。
Dockerを使うと同じイメージからコンテナを起動させるだけなので、楽だし、差異が発生しない。
heroku上にドッカーコンテナを起動させ、アプリを公開する。herokuはサーバーとかOS、ミドルウェアを自動で構築管理するサービス。インフラを簡単に構築して、本番環境にアプリケーションを公開するサービス。
heroku上にDockerコンテナを後悔する。

［全体の流れ］

①事前準備［GitHub・Herokuの登録、Heroku Cliのインストール］

git config --global merge.ff falsese
git config --global pull.rebase merges
git config --list

②herokuにログイン

heroku login

③herokuアプリを作成　

heroku create rails-docker-haruki　→herokuアプリの作成
herokuコンテナレジストリ　→Dockerのイメージ置き場。
heroku container:login　→イメージをコンテナレジストリにアップする。

④DBを追加・設定　

heroku addons:create cleardb:ignite -a rails-docker-haruki　→アドオンでデータベースの追加
本番環境のDBの接続先の仕組みは環境変数にして渡す。環境変数とはローカル環境や本番環境など、環境によって値を変える仕組み。GitHubにソースを渡すとデータベースに不正侵入されるので、アップしない。接続先を環境ごとに切り替えることができる。
database.ymlの設定を変更する。→<%= ENV[‘APP_DATABASE’] %>、<%= ENV[‘APP_DATABASE_USERNAME’] %>、<%= ENV[‘APP_DATABASE_PASSWORD’] %>、<%= ENV[‘APP_DATABASE_HOST’] %>
heroku config -a rails-docker-haruki　→データベースの接続先情報を確認する

環境変数を登録↓

heroku config:add APP_DATABASE_USERNAME=’b62bf1f80ee25a’ -a rails-docker-haruki
heroku config:add APP_DATABASE_PASSWORD=’184b8d73’ -a rails-docker-haruki
heroku config:add APP_DATABASE_HOST=’us-cdbr-east-03.cleardb.com’ -a rails-docker-haruki
heroku config:add APP_DATABASE=’heroku_8b739f60fccba26’ -a rails-docker-haruki

・heroku config -a rails-docker-haruki　→環境変数の確認

⑤Dockerfileを本番環境用に修正 heroku config:add RAILS_SERVE_STATIC_FILES=’true’ -a rails-docker-haruki→アセットプリコンファイルが本番で起動する

⑥Dockerイメージをビルド・リリース

heroku container:push web -a rails-docker-haruki　→ドッカーイメージをビルドしてコンテナレジストリーにビルドしたイメージをプッシュする
heroku container:release web -a rails-docker-haruki　→dockerのコンテナをherokuにリリースした
heroku run bundle exec rake db:migrate RAILS_ENV=production -a rails-docker-haruki　→データベースのテーブルを変更する時に使う　
heroku run　→herokuに対してコマンドを実行する場合に使う
docker-compose up -d　→ローカルのコンテナで実行
docker-compose exec web bundle exec rake db:migrate　→ローカルで実行
heroku open　→herokuのアプリを開く
heroku config:add RAILS_LOG_TO_STDOUT=’true -a rails-docker-haruki　→herokuのログを表示させる
heroku logs -t -a rails-docker-haruki　→herokuのログを見る

⑦機能追加

docker-compose up -d　→開発するようにサーバーを立ち上げる
docker-compose exec web bundle exec rails g controller users　→コントローラーを作る
heroku container:push web -a rails-docker-haruki
heroku container:release web -a rails-docker-haruki

nakatievent commented 3 years ago

エラー発生

heroku container:push web -a rails-docker-harukiコマンドを実行してDockerイメージをビルドしてコンテナレジストリにプッシュしようとしたら下記のようなエラーが出た。

Error: trust data missing for remote repository registry.heroku.com/rails-docker-haruki/web or remote repository not found: timestamp key trust data unavailable.  Has a notary repository been initialized?
 ▸    Error: docker push exited with Error: 1

試したこと①

Dockerイメージをビルドしてないからエラーが出るのかと思いdocker-compose buildした後にコンテナの作成・起動をdocker-compose up -dでやって再度heroku container:push web -a rails-docker-harukiコマンドを実行したが変わらず上記のエラーメッセージが出る。。。

試したこと②

export DOCKER_CONTENT_TRUST_SERVER=https://notaryserver:4443をターミナルに入力して上記コマンドを実行したところエラーメッセージが変わった。

Error: error contacting notary server: dial tcp: lookup notaryserver: no such host
 ▸    Error: docker push exited with Error: 1

翻訳すると

エラー：公証人サーバーへの接続エラー：ダイヤルtcp：ルックアップ公証人サーバー：そのようなホストはありません
  ▸エラー：docker pushがエラーで終了しました：1

もう訳わからん。。。

nakatievent commented 3 years ago

↑解決

恐らく、Docker Content Trust（DCT）が有効になっていて、イメージを利用する際（push時とか）に「発行者」と「イメージが改ざんされていないこと」を検証する機能が働いたと推測。

なので、解決策としてはopen /.zshrcコマンドでファイルを開き、export DOCKER_CONTENT_TRUST=1を消去すると無事heroku container:push web -a rails-docker-harukiコマンドを実行することができた。

なぜこうなったかというと、過去にDockerの勉強をしようと下記の記事を進めた際にDCTを設定していたからである。最強のLaravel開発環境をDockerを使って構築する

DCTを有効にしたい方にとっては「じゃあどのコマンドを実行すればエラー解決するの？」という話になりそうですが、今回はこれで進めていく。

nakatievent commented 3 years ago

【Docker超入門 #9】CI/CDを構築しよう

Githubにソースコードを共有する。
CI＝ビルド・テストを自動実行（バグが無いかなどコードの品質を一定に保つ・コードが変更されるたびに自動でテストを行う）
CD＝自動デプロイ（継続的デリバリー）＝変更を取り込んだら自動的にデプロイする
CircleCI＝CI/CD構築サービス（ビルド・テスト・デプロイを自動的に行う）
Gitコマンドは省略する。
.gitignore　→バージョン管理する必要の無いファイルをバージョン管理下から外す（機密情報とかが書いてあるファイル）

CI

「全体の流れ」

①テストコード記載

②CircleCIに登録 登録する際にGithubと連携させたいので「Githubで登録」を選択する。プクロジェトの直下に.circleci/config.ymlを作り、config.yml上にCircle CIの設定を書くとCircle CIが動作する。

③プロジェクトを登録

④configを設定 APP_DATABASE_HOST: "127.0.0.1" →自分のコンピューターという意味

⑤環境変数を設定 master.keyの追加 heroku config:add RAILS_MASTER_KEY='f2f6e61f4fb485d1aba29bd18f34bfc0' -a rails-docker-haruki

⑥GitHubにプッシュ git switch -c ci git add . git commit -m “CircleCIが動くようにconfigファイルを設定” git push origin ci

⑦テストを修正 docker-compose exec web bundle exec rake test

git pull origin main

CircleCIめっちゃ便利やん！

CD

「全体の流れ」 ①configを修正 git checkout -b cd git branch -d ci

②環境変数を設定 circle_ciにログインし、projectからproject_settings→Environment Variableで環境変数を設定する HEROKU_API_KEY

③Viewファイルを修正 docker-compose buildしてdocker-compose up -dしてlocalhost:3000してもページに飛ばない場合はrm src/tmp/pids/server.pidしてみる。

④GitHubにプッシュ

⑤マージ、デプロイ

マージしたらデプロイが走る。
デプロイ終わってもherokuに反映されるのに時間がかかる。
heroku logsでデプロイの状態を確認できる
heroku open -a rails-docker-haruki
heroku config:unset RAILS_MASTER_KYE -a rails-docker-haruki　←設定の解除
circleCI上でデプロイをやり直すことができる
120秒以内でデプロイできなかったらエラーが表示され、もう一度デプロイしなおさなければならない。→Error R10 (Boot timeout) -> Web process failed to bind to $PORT within 60 seconds of launch

まとめ

Dockerイメージとコンテナ
Dockerfile
Docker Compose
ProductionでのDocker運用
Linuxコマンド
GitとGithub
Heroku
CI/CD
CircleCI

nakatievent commented 3 years ago

米国AI開発者がゼロから教えるDocker講座

echo $SHELLで使っているシェルの種類が見れる Docker imageはDockerのコンテナを作る元となる物（コンテナはDocker imageから作られる） Docker imageはDockerfileから作られる

nakatievent / my_baby_diary_app

Docker・CircleCIについて #13

【Docker超入門】Dockerって何？何が良いの？

【Docker超入門】環境構築 for Mac

【Docker超入門 #3】Linuxの基本コマンド

【Docker超入門】Dockerを使ってみよう

【Docker超入門 #5】アプリを作成・実行しよう

①コンテナのライフサイクル

②コンテナの操作でよく使う操作として、①ログ、②コマンド実行、③お掃除がある

【Docker超入門 #6】Dockerfileを作成しよう

【Docker超入門 #7】Docker ComposeでRailsを構築しよう

基本操作

全体の流れ

【Docker超入門】本番環境に公開しよう

［全体の流れ］

環境変数を登録↓

エラー発生

試したこと①

試したこと②

↑解決

【Docker超入門 #9】CI/CDを構築しよう

CI

「全体の流れ」

CD

まとめ

米国AI開発者がゼロから教えるDocker講座