プロジェクトの準備
このページで扱う手順で、Git がインストールされていることを確認します。
1. サンプルリポジトリのクローン
以下のコマンドで、Git がインストールされていることを確認します。
git --version
以下のように Git のバージョンが表示されれば、インストールは確認できています。
git version 2.x.x
バージョンが表示されない場合は、Git/GitHubのセットアップ を先に実施してください。
インストールが確認できたら、この章で使用するノートアプリケーションのソースコードをGitHubのサンプルリポジトリからクローンします。コマンドプロンプト(Windows)またはターミナル(Mac)を開き、任意の場所で以下のコマンドを実行します。
git clone https://github.com/gevanni-academy/sample-note-api.git
クローンが完了したら、Visual Studio Codeを起動し、「ファイル」→「フォルダーを開く」から、クローンしたsample-note-apiフォルダを開いてください。以降の操作は、Visual Studio Codeのターミナルから行います。
2. フォルダ構成の確認
クローンしたリポジトリのフォルダ構成は以下のようになっています。
sample-note-api
├── api/
│ ├── Dockerfile
│ ├── main.py
│ ├── models.py
│ ├── database.py
│ ├── requirements.txt
│ └── routers/
│ └── notes.py
└── front/
├── Dockerfile
├── index.html
├── style.css
└── script.js
各フォルダは3層アーキテクチャの各層に対応しています。
| フォルダ | 層 | 内容 |
|---|---|---|
| api/ | アプリケーション層 | FastAPIのソースコード、Dockerfile、requirements.txt |
| front/ | プレゼンテーション層 | HTML/CSS/JavaScriptのフロントエンド、Nginx用のDockerfile |
データベース層はMySQLの公式イメージをそのまま使うため、ソースコードのフォルダはありません。
| 💡 ポイント |
|---|
リポジトリにはcompose.yamlやdb/フォルダも含まれていますが、これらは後続の章で使用するファイルです。この章では使用しないため、無視してください。 |
| 💡 ポイント |
|---|
| PythonやFastAPIの詳しい説明は省略します。コードの詳細については PythonでREST APIを作ろう に記載があります。この章では、Dockerの操作に集中します。 |