go-techblog

概要

個人用の技術系プログサイト

• 閲覧者向け画面

  

• 投稿者向け画面

  

動機

学んだ技術の陳腐化を防ぐため、QiitaやZennなどのブログサイトに技術的なアウトプットをしたかったが、敷居が高く重い腰が上がらなかったため、気軽にアウトプットできる環境が欲しかった

技術的な挑戦や工夫した点

• 開発環境構築にDocker・Docker Composeを導入して、ローカル環境を汚さないようにした点
• GoのフレームワークやORMパッケージを適宜導入して、冗長なコードを減らし、作業工数を削減した点
• DIを使って単体テストが書きやすい設計を意識して実装した点
• ホットリロードを行うパッケージを導入し、コードを更新するたびにdockerを再起動する手間を削減した点
• DBのパスワードなどセキュリティレベルの高い情報を環境変数に設定することで、秘匿性を向上させた点
• Basic認証により、パスワードを知っている人だけが記事に関する操作ができるようにした点

課題

• HTML, CSS, JavaScriptをそのまま使っており、コード量が多くなっている
• 編集ボタンのような、サイト閲覧者から見える必要のない要素がページに入っているので、認証によりアクセス制御する必要がある
• コンテナの利用が開発環境に止まっており、コンテナの強みが活かしきれていない

TODO

• OAuth認証のようなJWTなどアクセストークンを用いるよりセキュリティが考慮された認証機能を導入して、アクセス制御をする
• ReactやVueなどのフレームワークを導入して、冗長になっている箇所をコンポーネント化するなど、フロントエンドのコード量を減らしたり、Webページのパフォーマンスを意識してみる
• インフラの構成管理にTerraformを導入して、保守しやすくする
• 自己紹介用のサイトに組み込み、UXを向上させる
• テストコードを書く & Github ActionsのようなCI/CDサービスを使って自動テスト・自動リリースを行う

開発してみて

• フロントエンドの実装〜APIサーバの構築、DBのCRUD操作、デプロイのようなWebアプリに必要な工程を一通り行い、一つのWebアプリとして公開できたことで、開発の全体感を掴む良い機会となった。
• 今回Webアプリ開発に必須のDockerを使ってみたが、比較的簡単に環境構築を行うことができ、便利なツールだと感じた。今回はいろんなサイトや公式ドキュメントを通じて手探りで作ったため、もう少しcomposeやDockerfileの書き方を調査して、使いこなせるようになりたい。
• 今回は必要最小限の構成で作ったため、これからUI/UXの向上、パフォーマンスやセキュリティなど実運用されるアプリを意識してで作ってみたいと思う。

使用技術

フロントエンド：HTML,CSS,JavaScript
バックエンド：Go, sqlx, air
フレームワーク：Echo
DB：DockerのMySQLコンテナ、本番環境はClearDB（MySQL）
開発環境構築：Docker, Docker Compose
インフラ：Heroku

DBマイグーイション（golang-migrate/migrate）

GitHubリポジトリ

ファイルの作成

migrate create -ext sql -dir YOUR_DATABASE_DIRECTORY -seq YOUR_FILE_NAME

ex

migrate create -ext sql -dir db/migrations -seq create_aritcle

マイグレーションの実行

環境依存情報の設定

export MYSQL_URL="mysql://go_user:password@tcp(127.0.0.1:3306)/go_db?multiStatements=true"

マイグレーションファイルの作成

migrate create -ext sql -dir db/migrations -seq create_articles_table

マイグレーションの実行

migrate -database ${MYSQL_URL} -path=db/migrations/ up 1

実行

docker compose up -d

停止

docker compose down

コンテナで立ち上げたMySQLに接続する

docker exec -it コンテナ名 bash

ホストはlocalhostと指定するとローカルマシンのmysqlソケットを探しに行くのでエラーになるので、127.0.0.1ホストを指定

mysql -u 127.0.0.1 -P 3306 -u ユーザ名 -p