基本設計とは、システム開発における工程の一つで、要件定義で定義した要件を機能別に分け、それぞれの機能が「何を実現するのか」を具体的に決定することです。基本設計の工程ではシステムの全体像を大まかに捉えることを目指します。基本設計の結果や成果をまとめた資料を基本設計書といいます。

基本設計とは？

システム開発は「要件定義」「基本設計」「詳細設計」「開発」「導入」という流れで行われます。基本設計は要件定義で開発するシステムの目的を明らかにした後に、それをどのように実現するのかという概要をまとめる役割を持っています。

システム開発での役割

インフラとはインフラストラクチャーの略で、システムやアプリケーションを動かすために必要な基盤部分を指します。そのため、インフラでの開発はコードを書くプログラミングを行いません。インフラ開発をする場合には、通常のシステム開発とは基本設計に必要な項目が異なり、サーバ数やサーバのスペック、OSを何にするかの指定などを基本設計に盛り込む必要があります。

インフラの場合は、基本設計に必要な項目が異なる

システム開発において外部に開発を委託する場合が多くあります。その場合に発注時点の要望と実際の開発の方向性が合っているかをすり合わせる必要があり、そこで重要な役割を果たすのが基本設計です。基本設計の工程は発注者側にシステムの完成の全体像を提示する役割と、開発者側にシステム開発の方法を提示する役割の二つを担っており、両者の方向性を合わせることができます。

方向性を合わせるため

作業工程の途中で問題が見つかった場合、それ以前の作業段階に戻ってやり直さなければなりません。システム開発は前の工程を全て完成させてから次の工程に移る手法をとるため、手戻りをすることになった場合は費用と時間の大幅なロスにつながります。しかし、基本設計で要件定義の内容を実現する方法をしっかりとまとめておけば、手戻りを防ぐことができます。無駄なコストをかけないために、基本設計をしっかりと行うことは重要です。

手戻りをなくすことができる

基本設計、詳細設計を行う重要性についてまとめましたが、システムエンジニアであればどちらの設計も行う機会があると思います。それぞれがどのような目的、役割を持っている工程なのかを理解した上で作業を行わなければ、以降の工程がスムーズに進まなくなる可能性があります。費用や時間などコストを見据えて、費用な工程をしっかりとこなしていくことがとても大事になります。自分自身もそうですが、今一度各工程に必要な目的などをしっかりと確認した上で作業を行っていきたいですね。

最後に

基本設計が重要な理由

基本設計の作成

詳細設計とはシステムやソフトウエアを開発する工程の一つになります。要件定義や基本設計で定めた要素や実践方法の詳細を具体的に定義する工程となります。詳細設計では開発を行う上での、システムの仕様の詳細をまとめる役割を持ちます。また、開発者向けの詳細設計や成果物をまとめた資料を詳細設計書といい、詳細設計書はシステム設計とシステム開発の橋渡しとなる重要な資料です。

詳細設計とは？

詳細設計は、システム開発の工程において基本設計の次に行います。基本設計で大まかに定められた内容に基づき、システムの実現方法を詳細に決定していきます。基本設計と詳細設計では、目的が大きく異なります。基本設計ではシステムのユーザーが直接目に見える部分の機能を構築するために設計します。詳細設計では基本設計で構築した機能を実現するためのシステムの中身の部分を構築するために設計します。

基本設計との違いとは？

詳細設計を行うことで、開発の品質水準を安定させることができます。細かく開発方法を設定することで、開発者の経験値に依存することなく、安定したパフォーマンスで開発ができるようになります。

一定水準の品質を保つため

開発者が一から開発の方法を考えることになった場合、多くの時間と労力が必要になります。しかし、事前に開発の具体的なルールや方向性を決定しておくことで、効率的に開発が行えるようになります。また、開発を効率的に行うことにより、開発後の検証や確認作業に時間を多く費やすことができるようになります。「生産性の向上」および「システムの品質の向上」を実現することができることから、詳細設計は重要な役割を果たす工程と言えます。

効率的な開発のため

開発した後に詳細設計書をもとにシステムを検証することができます。検証をせずにリリースしてしまった場合、システムエラーが生じてしまう可能性がありますが、詳細設計書があれば事前に回避することができます。詳細設計書に基づいて検証を行えば、検証作業も効率的に行えます。

開発後の検証を行うため

冒頭にも記載しましたが、システムエンジニアとは他人が見てもある程度理解のできる成果物が必要になります。どのようなデータが必要になるか、どんな機能が実装されているのか、どのような場合にエラーが発生するのか、etc...挙げるとキリがありませんが、様々な状況・場面を想定してルールを定義することはとても重要になります。ルールのない状態から開発するのは経験が浅いと本当に難しく、また経験がある程度あってもユーザーやクライアントにシステムの説明を行う際の資料がソースコードしかないと相手が理解するのに時間を要します。その指標となるものとして、詳細設計が存在するので作業工程の意味と必要性を理解した上、作業を進めていくことが大事だと思います。

なぜ詳細設計が必要なのか

詳細設計の作成

Oracleの基本的なコマンドを紹介いたします。データベースの作成<pre><code>CREATE TABLE table_name (
 column1 datatype,
 column2 datatype,
);</code></pre>テーブル削除<pre><code>DROP TABLE table_name;</code></pre>データ挿入<pre><code>INSERT INTO table_name (column1, column2) VALUES (value1, value2);</code></pre>データ更新<pre><code>UPDATE table_name SET column1 = value1 WHERE condition;</code></pre>データ削除<pre><code>DELETE FROM table_name WHERE condition;</code></pre>データを取得<pre><code>SELECT * FROM table_name;</code></pre>データを条件取得<pre><code>SELECT column1, column2 FROM table_name WHERE condition;</code></pre>以上になります。DBマッピングのプロジェクトに参画しているため、SQLをより使いこなせていきたいです。

OracleSQL 入門

COBOLは事務処理系の処理を得意としております。また、基幹システムでも使用されていることもありますが、主に「事務処理用プログラムを効率的に開発できる」ことが最適となります。人間の言葉に近い文法でプログラムを記述できるため、比較的に習得が容易です。プログラミング入門として、入りやすい言語となります。

どんな業務に最適な言語なのか

ファイルの読み込みや書き込みが行えます。また、ファイルに大量のデータを書き込んだり、ソートやマージしてデータを並び替える作業を、高速で処理することが可能です。さらに事務処理で作成された帳票の出力も行うことができます。データを10進数で表現できるため、金額や各種データの確認を容易に行うこともできます。また、COBOLはWindowsやLinux／Unixなど、様々なコンピューターで利用できるため、移植性が極めて高い言語になります。

どんなことができるのか

COBOLは大きく分けて、4つの部で構成されます。それぞれの部には「見出し」があります。プログラムは「見出し部（IDENTIFICATION DIVISION）」から始まり、「環境部（ENVIRONMENT DIVISION）」、「データ部（DATA DIVISION）」、「手続き部（PROCEDURE DIVISION）」と処理を順に記載していきます。見出し部以外は省力可能で、部（DIVISION）の中にはいくつかの節（SECTION）や段落があります。 ・見出し部（IDENTIFICATION DIVISION）見出し部はCOBOLプログラムを識別するための部で、見出し部のみ節はありません。PROGRAM-IDには作成するプログラム名などの情報を記述します。<pre><code>IDENTIFICATION DIVISION.
PROGRAM-ID. [プログラム名など].</code></pre> ・環境部（ENVIRONMENT DIVISION）環境部はプログラムを適用するコンピュータ名や、環境変数などの情報の定義を行う構成節（CONFIGURATION SECTION）と、プログラムファイルを使用する場合に記述する入出力節（INPUT-OUTPUT SECTION）があります。<pre><code>ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
INPUT-OUTPUT SECTION.
FILE-CONTROL.
SELECT ファイル項目 ASSIGN TO 'ファイル名'</code></pre> ・データ部（DATA DIVISION）データ部はファイル節（FILE SECTION）、作業場所節（WORKING-STORAGE SECTION）、連絡節（LINKAGE SECTION）、通信節（COMMUNICATION SECTION）などから構成されます。主にプログラムで使用するデータ項目やファイルのレコードの宣言を行います。<pre><code>DATA DIVISION.
FILE SECTION.
FD ファイル項目.
01 ファイルレコード.
05 データ項目1 PIC 9(5).
05 データ項目2 PIC X(3).</code></pre>上記の例では、ファイル節にファイル記述項（FD）とファイルのレコード定義を行っています。 ・手続き部（PROCEDURE DIVISION）手続き部では主に各種処理を宣言したり、実行される手続きやエラーになった場合の処理内容を記述します。また、STOP文を記述すれば、プログラムを終了させることができます。<pre><code>PROCEDURE DIVISION.
MAIN SECTION.

実行処理...

STOP RUN.</code></pre>

プログラムの書き方

以上になります。古い言語と言われるCOBOLですが、まだ需要はあります。やってみると意外に簡単に読むことができますし、形式さえ覚えてしまえば処理も容易に記述が可能です。この機会に一度、触ってみるのはいかがでしょうか。構成やどのような場面で使われているかの概要のみでしたが、以下のサイトに詳しく書いてあります。 <blockquote>参考：<a href="https://www.cobol.co.jp/cobol-nyuumon/kiso/k001/" target="_blank" rel="noopener noreferrer">COBOL入門</a></blockquote>

COBOLの特徴

COBOL言語の概要

さっそくですが本題のMakefileをお見せします。<code>Makefile</code>というファイルをプロジェクトのルートディレクトリに作成し、以下の内容を記載します。<pre><code># makeを打った時のコマンド
.DEFAULT_GOAL := help


.PHONY: up down build ps api mysql help


up: ## コンテナ起動
	docker-compose up
down: ## コンテナ停止
	docker-compose down
build: ## コンテナビルド
	docker-compose build
ps: ## コンテナのステータス確認
	docker-compose ps
project-api: ## project-apiコンテナに入る
	docker-compose exec -it project-api /bin/bash
mysql: ## mysqlコンテナに入る
	docker-compose exec -it mysql /bin/bash


help: ## ヘルプ
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'

</code></pre> 作成したらMakefileと同じ階層で<code>make</code>もしくは<code>make help</code>コマンドを実行して、ヘルプが使用可能なコマンドとそれぞれのコマンドの説明が表示されることを確認しましょう。<pre><code>$ make
up&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; コンテナ起動
down&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; コンテナ停止
build&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; コンテナビルド
ps&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;コンテナのステータス確認
project-api&nbsp; &nbsp; &nbsp; &nbsp; manager-apiコンテナに入る
mysql &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;mysqlコンテナに入る
help&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;ヘルプ</code></pre>

Makefileを作成する

使い方は他のコマンドと同じです。<code>$ make ターゲット</code>という形式でターミナルに入力して実行するだけで使えます。 例えば、<code>$ docker compose up</code>をしたい場合には、ターミナルに<code>$ make up</code>と入力して実行します。同様にコンテナを停止する場合は<code>$ make down</code>、ビルドする場合は<code>$ make build</code>で実行できます。

Makefileの使用方法

Makefile内の各項目について解説していきます。 <h3 id="h1eaa05f1fe">.DEFAULT_GOAL</h3>コマンドラインでターゲットが指定されなかった場合に使用されるデフォルトの動作を定義します。今回はコマンドの説明を表示するために help をデフォルトのターゲットとして設定しています。 <h3 id="hb88a63c6c5">.PHONY</h3>ターゲットと同名のファイルが作成された場合にコマンドが正しく動作しなくなることを回避するために定義します。 例えば、cleanというターゲットがあるとします。<pre><code>clean:
	rm *.o temp</code></pre> このままの状態だと、同じディレクトリ内にcleanという名前のファイルが作成された場合に、<code>$ make clean</code>コマンドが正常に動作しなくなります。このような名前の衝突を避けるため、.PHONYにcleanターゲットを記載する必要があります。<pre><code>.PHONY: clean
clean:
&nbsp;&nbsp;&nbsp;&nbsp;rm *.o temp</code></pre> <h3 id="h0c03e9cae9">up, down, build, ps ターゲット</h3>それぞれdocker-composeのup, down, build, psコマンドを実行します。up: がターゲット、その下の行が実際に実行するコマンドという構成です。 <h3 id="h390dd1d079">project-api, mysql ターゲット</h3>APIサーバー用のコンテナやmysqlコンテナに入るためのdocker-compose execコマンドを実行します。コマンドが長いのでよく設定していますが意外と便利です。ご自身のプロジェクトのコンテナ名に書き換えて使用してください。<pre><code>&lt;コンテナ名&gt;:
	docker-compose exec -it &lt;コンテナ名&gt; /bin/bash</code></pre> <h3 id="h6487ef0f90">help ターゲット</h3>Makefile内のターゲットと説明を出力するために設定しています。ファイル内で<code>## コンテナ起動</code>のようにシャープ2つの後に続けて説明を記載しておくと以下のように説明として出力されます。<pre><code>$ make
up&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;コンテナ起動
down&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;コンテナ停止
build&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;コンテナビルド
ps&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;コンテナのステータス確認
project-api&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;manager-apiコンテナに入る
mysql&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;mysqlコンテナに入る
help&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ヘルプ</code></pre>

Makefileの解説

本題

いかがでしたでしょうか。他にもテスト用のコマンドなどを作成してみてもいいかもしれないですね。Makefileを作成してmakeコマンドが使えるようになると開発の効率がかなり上がるので、皆さんもぜひやってみてください。 参考：・<a href="https://www.gnu.org/software/make/manual/html_node/index.html" target="_blank" rel="noopener noreferrer">Top (GNU make)</a>・<a href="https://qiita.com/sun33/items/d728bc9ec27129b53e17" target="_blank" rel="noopener noreferrer">docker-composeを詠唱する黒魔術「Makefile」入門 #Docker - Qiita</a>・<a href="https://zenn.dev/yuki_tu/articles/ad7f95b0b2482e" target="_blank" rel="noopener noreferrer">Makefileで開発効率をあげよう！</a>

まとめ

5分で作る「Makefile」 for docker-compose

まず初めにDockerfile、docker-compose.yaml、.dockerignoreを作成していきます。docker init コマンドを実行すると順番に以下の選択・入力を求められるので、聞かれるままに答えていくと自動的にDockerfileなどが生成されます。（<a style="background-color:#ffffff" href="https://yoku-tech-blog.microcms.io/apis/articles/%E5%85%AC%E5%BC%8F%E3%81%AE%E3%83%96%E3%83%AD%E3%82%B0" target="_blank" rel="noopener noreferrer">公式のブログ</a>） <ul><li>使用言語</li><li>バージョン</li><li>メインパッケージの相対ディレクトリ</li><li>サーバーのリッスンポート</li></ul> <pre><code>$ docker init

Welcome to the Docker Init CLI!

This utility will walk you through creating the following files with sensible defaults for your project:
&nbsp;- .dockerignore
&nbsp;- Dockerfile
&nbsp;- docker-compose.yaml

Let's get started!

? What application platform does your project use? Go
? What version of Go do you want to use? 1.18
? What's the relative directory (with a leading .) of your main package? .
? What port does your server listen on? 8080

CREATED: .dockerignore
CREATED: Dockerfile
CREATED: docker-compose.yaml

✔ Your Docker files are ready!

Take a moment to review them and tailor them to your application.

When you're ready, start your application by running: docker compose up --build -d

Your application will be available at http://localhost:8080

To stop your application, run: docker compose down</code></pre>

1. docker init でファイルを自動生成する

次に go mod init コマンドを実行してGoモジュールを初期化します。helloworldの部分はプロジェクト名なので何でも良いです。<code>$ go mod init helloworld</code>このコマンドを実行するとgo.modが生成されます。

2. go mod init で新しいGoモジュールを初期化する

go.modが作成できたら、go get コマンドを実行してGinをインストールします。<code>$ go get -u github.com/gin-gonic/gin</code>このコマンドを実行するとgo.modが変更され、go.sumが生成されます。

3. go get でGinをインストールする

最後に main.go を作成し、以下のコードをコピペします。内容としては <code>/hellowworld</code> に向けてGETすると Hello World! が返ってくるという簡単な内容です。<pre><code>package main

import (
	"net/http"
	"github.com/gin-gonic/gin"
)

func main() {
	r := gin.Default()
	r.GET("/helloworld", func(ctx *gin.Context) {
		ctx.JSON(http.StatusOK, gin.H{
			"message": "Hello World!",
		})
	})
	r.Run()
}</code></pre> ここまで作成したら、プロジェクト内のファイルは以下のようになっているはずです。不足している場合は手順を戻って生成しましょう。<pre><code>.
├── Dockerfile
├── docker-compose.yaml
├── .dockerignore
├── go.mod
├── go.sum
└── main.go</code></pre>

4. main.goを用意する

<code>$ docker compose up --build</code> を実行します。<code>Listening and serving HTTP on :8080</code> と表示されたらOKです。<pre><code>&nbsp;✔ Container docker_init_test-server-1&nbsp;Recreated&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0.1s
Attaching to docker_init_test-server-1
docker_init_test-server-1&nbsp;| [GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.
docker_init_test-server-1&nbsp;|
docker_init_test-server-1&nbsp;| [GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
docker_init_test-server-1&nbsp;|&nbsp;- using env:&nbsp;&nbsp;&nbsp;export GIN_MODE=release
docker_init_test-server-1&nbsp;|&nbsp;- using code:&nbsp;&nbsp;&nbsp;gin.SetMode(gin.ReleaseMode)
docker_init_test-server-1&nbsp;|
docker_init_test-server-1&nbsp;| [GIN-debug] GET&nbsp;&nbsp;/helloworld&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--&gt; main.main.func1 (3 handlers)
docker_init_test-server-1&nbsp;| [GIN-debug] [WARNING] You trusted all proxies, this is NOT safe. We recommend you to set a value.
docker_init_test-server-1&nbsp;| Please check https://pkg.go.dev/github.com/gin-gonic/gin#readme-don-t-trust-all-proxies for details.
docker_init_test-server-1&nbsp;| [GIN-debug] Environment variable PORT is undefined. Using port :8080 by default
docker_init_test-server-1&nbsp;| [GIN-debug] Listening and serving HTTP on :8080</code></pre>

5. docker compose up --build でコンテナをビルドして立ち上げる

サーバーが立ち上がったはずなのでリクエストを投げて確認してみましょう。curlコマンドを使って /helloworld に向けてGETリクエストを投げます。<code>$ curl http://localhost:8080/helloworld</code> 以下のようなレスポンスが返ってきていればOKです。<pre><code>&nbsp;% curl http://localhost:8080/helloworld
{"message":"Hello World!"}%</code></pre>

6. curlでレスポンスが返ってくるか確認

エラー例）<pre><code>&nbsp;=&gt; ERROR [build 3/4] RUN --mount=type=cache,target=/go/pkg/mod/&nbsp;&nbsp;&nbsp;--mount=type=bind,source=go.sum,target=go.sum&nbsp;&nbsp;&nbsp;&nbsp;0.2s
------
&nbsp;&gt; [build 3/4] RUN --mount=type=cache,target=/go/pkg/mod/&nbsp;&nbsp;&nbsp;--mount=type=bind,source=go.sum,target=go.sum&nbsp;&nbsp;&nbsp;--mount=type=bind,source=go.mod,target=go.mod&nbsp;&nbsp;&nbsp;go mod download -x:
#0 0.205 go: errors parsing go.mod:
#0 0.205 /src/go.mod:3: invalid go version '1.21.3': must match format 1.23
------
failed to solve: executor failed running [/bin/sh -c go mod download -x]: exit code: 1</code></pre> こんなエラーが発生したら、go.modに記載されているgoのバージョンを <code>1.21.3</code> → <code>1.21</code> のように修正し、その後再度 <code>$ docker comose up --build</code> を実行します。 <pre><code>module helloworld

go 1.21.3 ←こいつを1.21に変更

require (
	github.com/bytedance/sonic v1.10.2 // indirect
	github.com/chenzhuoyu/base64x v0.0.0-20230717121745-296ad89f973d // indirect
	github.com/chenzhuoyu/iasm v0.9.1 // indirect
	github.com/gabriel-vasile/mimetype v1.4.3 // indirect
	github.com/gin-contrib/sse v0.1.0 // indirect
	github.com/gin-gonic/gin v1.9.1 // indirect</code></pre> おそらくエラーが解消してサーバーが立ち上がります。

docker compose up --buildでエラーが出るとき

おまけ

docker init コマンドが非常に便利ですね。 もし、ここまで記事を読んでDockerってそもそもなんぞやと思った方はこちらの記事で解説しているので合わせてどうそ。<a href="https://build.yoku.co.jp/articles/a_y-w8d81" target="_blank" rel="noopener noreferrer">https://build.yoku.co.jp/articles/a_y-w8d81</a>

Docker+Go+GinのAPI開発環境を5分で作る

App Store リンク：<a href="https://apps.apple.com/jp/app/daisydisk/id411643860?mt=12" target="_blank" rel="noopener noreferrer">https://apps.apple.com/jp/app/daisydisk/id411643860?mt=12</a> 料金：1500円 概要：Macのストレージ使用状況を階層構造で可視化してくれるアプリです。どのファイル・フォルダにどれくらいの容量が使用されているのかが一目でわかり、そのままアプリ上から削除することも可能になっています。ユーザーインターフェースが非常にシンプルで洗練されているので、面倒だったデータの整理が少し楽しくなり重宝しています。<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/f6411a398bed496cb13edb306129e145/Screenshot%202024-01-04%20at%2013.21.54.png" alt="">

DaisyDisk

App Store リンク：<a href="https://apps.apple.com/jp/app/as-timer/id512464723?mt=12" target="_blank" rel="noopener noreferrer">https://apps.apple.com/jp/app/as-timer/id512464723?mt=12</a> 料金：無料 概要：タイマー機能のみの非常にシンプルなアプリです。MacOSのタイマーにはない無音アラームの機能やウインドウの最前面に固定する機能など、単純ですが意外となかった機能が備わっていて優秀です。

AS Timer

GitHub リンク：<a href="https://github.com/SelfControlApp/selfcontrol" target="_blank" rel="noopener noreferrer">https://github.com/SelfControlApp/selfcontrol</a> 料金：無料 概要：あらかじめ登録しておいたサイトを設定された時間の間閲覧できなくなるアプリです。別途で曜日ごとに時間設定できる設定アプリ(<a href="https://github.com/AlexanderDickie/auto-selfcontrol-rs" target="_blank" rel="noopener noreferrer">こちら</a>)もあるので、そちらも合わせて使用すると手間が省けて生産性爆上がりです。本業終わりの自学自習や副業の時に気を抜くとついつい関係のないサイトやYoutubeを見てしまうなんて方はぜひ使ってみてください。

SelfControl

非常にざっくりとした紹介でしたがいかがだったでしょうか。個人的に一番オススメなのは最初に紹介したDaisyDiskです。今回紹介したアプリをまだ使ったことがない方はぜひ導入して試してみてください。

2023年に導入した個人的便利アプリ3選

複数のコンテナで構成されるアプリケーションについて、Dockerイメージのビルドや各コンテナの起動・停止などをより簡単に行えるようにするツールです。簡単に言うと、Dockerは1度に1つずつしか操作できないことに対し、Docker Composeは1度に複数のコンテナを操作できるということです。 メリットとしては、<ol><li>複数コンテナを簡単・効率的に管理・実行できるようになる</li><li>コンテナを運用する際のミスを軽減できる</li><li>コンテナ間のネットワーク設定が簡単になる</li></ol>といったことがあげられます。

Docker Composeとは

<pre><code>version: '3'
services:
 db:
 image: mysql:5.7
 environment:
 MYSQL_ROOT_PASSWORD: password
 MYSQL_DATABASE: mydb
 web:
 image: httpd:2.4
 ports:
 - "8081:80"
 volumes:
 - ./public-html:/usr/local/apache2/htdocs/</code></pre> DBは、環境変数を使用してルートパスワードとデータベース名が設定しています。これでlocalhost:8081に接続完了しました。 ここから先はまだ学習中なので、どういった場面で使えるとか、もう一つサービスを追加してみるなど少しずつ応用をしていってキャッチアップしていきたいと思います。

MySQLとApacheを含む2つのサービスを定義してみました

実際にDocker Composeを作成してみる

Docker Compose使ってみた

Dockerfileを基にDocker imageを作成していきます。今回は簡単に以下のような形でDockerfileを作成しました。<pre><code>#ベースになるコンテナ
FROM ubuntu:16.04

#システムのパッケージをアップグレード、apache2、nginxパッケージをインストール
RUN apt-get update &amp;&amp; apt-get upgrade -y &amp;&amp; \
apt-get install apache2 -y
RUN apt-get update &amp;&amp; apt-get install -y -q nginx

#コマンドの指定
CMD ["/usr/sbin/apachectl","-DFOREGROUND"]</code></pre> それでは、作成したDockerfileを使ってDockerイメージを作成します。Dockerfileのあるディレクトリに移動して、Dockerビルド（Dockerイメージを作成するコマンド）を実行します。<pre><code>$ docker build -t &lt;Dockerイメージ名&gt; &lt;Dockerfileが存在するディレクトリ&gt;)</code></pre>これでDockerイメージが作成できました。このDockerイメージを使用して、コンテナを起動します。<pre><code>#今回は443番ポートでポートマッピングする必要があったので443番ポートにしてます。
$ docker run -it --name &lt;Dockerイメージ名&gt; -p 443:443</code></pre> 以上でDocker image,container作成完了。

Docker image,container作成

セクション1で作ったコンテナの中に入りApacheでオレオレ証明書を発行したいと思います。まず、秘密鍵の作成。<pre><code># cd /etc/ssl/private
openssl genrsa -aes256 -out server.key 4096
Generating RSA private key, 4096 bit long modulus (2 primes)
...................................................++++
....++++
e is 65537 (0x010001)
Enter pass phrase for server.key:
Verifying - Enter pass phrase for server.key:</code></pre>

秘密鍵の作成

<pre><code># openssl req -new -key server.key -out server.csr
Enter pass phrase for server.key:
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]:JP
State or Province Name (full name) [Some-State]:Tokyo
Locality Name (eg, city) []:
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Organizational Unit Name (eg, section) []:
Common Name (e.g. server FQDN or YOUR name) []:
Email Address []:

Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:</code></pre>

CSRの作成

今回は10年持つ証明書<pre><code># openssl x509 -in server.csr -out ../certs/server.crt -req -signkey server.key -days 3650
Signature ok
subject=C = JP, ST = Tokyo, L = AdachiKu, O = Internet Widgits Pty Ltd, CN = localhost
Getting Private key
Enter pass phrase for server.key:</code></pre>

証明書の作成

<pre><code># vim /etc/apache2/sites-available/default-ssl.conf 

#32, 33行目
SSLCertificateFile /etc/ssl/certs/server.crt
SSLCertificateKeyFile /etc/ssl/private/server.key</code></pre>

Apacheの設定

<pre><code># a2ensite default-ssl
Enabling site default-ssl.
To activate the new configuration, you need to run:
 systemctl reload apache2

# a2enmod ssl
Considering dependency setenvif for ssl:
Module setenvif already enabled
Considering dependency mime for ssl:
Module mime already enabled
Considering dependency socache_shmcb for ssl:
Enabling module socache_shmcb.
Enabling module ssl.
See /usr/share/doc/apache2/README.Debian.gz on how to configure SSL and create self-signed certificates.
To activate the new configuration, you need to run:
 systemctl restart apache2</code></pre>

SSL設定

このままcurlコマンド実行すると、ServerName を指定しろとエラーが出ちゃいます。なので、<code>/etc/hosts</code>と<code>/etc/apache2/apache2.conf</code>に指定していきます。<pre><code># vi /etc/hosts
127.0.0.1	localhost

::1	localhost ip6-localhost ip6-loopback

fe00::0	ip6-localnet

ff00::0	ip6-mcastprefix

ff02::1	ip6-allnodes

ff02::2	ip6-allrouters

172.17.0.2	www.myserver.hoge</code></pre> <pre><code># vi /etc/apache2/apache2.conf

# 一番最後に
ServerName&nbsp; &nbsp; &nbsp; www.myserver.hoge</code></pre>ServerNameを指定してあげることで、正確な通信経路を確立することができます。

FQDN を指定

Apacheでオレオレ証明書を発行

以上を設定することで、<pre><code>$ curl https://www.myserver.hoge</code></pre> 確認完了です。

curlコマンド確認

自分はエンジニアになって3ヶ月ほどの新米です。まだ、なにをするにも未熟で足りない部分が多くしんどくなることもありますが、挑戦したことに間違いはなかったと思っています。早く一人前になれるように、もっと質の高いブログかけるように日々精進します。ありがとうございました！

BuildersIO produced by YOKU

#未経験エンジニアの記事一覧

基本設計の作成

詳細設計の作成

OracleSQL 入門

COBOL言語の概要

5分で作る「Makefile」 for docker-compose

Docker+Go+GinのAPI開発環境を5分で作る

2023年に導入した個人的便利アプリ3選

Docker Compose使ってみた

Apacheでオレオレ証明書を発行して自分を証明したい

Auth0環境を構築して自作のAPIと連携してみた

OpenAIとDeeplのAPIを使ってChatGPTのCLIツール作ってみた

「Googleでログイン」を実装してみた〜トークンリフレッシュ編〜

#未経験エンジニア の記事一覧

基本設計の作成

詳細設計の作成

OracleSQL 入門

COBOL言語の概要

5分で作る「Makefile」 for docker-compose

Docker+Go+GinのAPI開発環境を5分で作る

2023年に導入した個人的便利アプリ3選

Docker Compose使ってみた

Apacheでオレオレ証明書を発行して自分を証明したい

#未経験エンジニアの記事一覧