はじめに
この数週間、私はHuella Digitalというオープンソースプロジェクトに参加し始めました。このプロジェクトは、COVID-19との戦いにあるボランティアのためのリソースへのアクセスを容易にするWebプラットフォームを作成することを目的としています。
この最初の投稿で話したいのは、このプロジェクトの開始にどのように取り組んだかということです。最初は少し迷っていて、何をすべきかわかりませんでした。しかし、同僚のDavidとAgustínのおかげで、プロジェクトをローカルにデプロイして作業を開始するためのガイドを一緒に作成することができました。
始めるには何が必要ですか？
大規模なプロジェクトと同様に、すべてが適切に実行されるためには、コンピューターにいくつかのテクノロジーが必要です。このためには以下が必要です：
- Huella digitalリポジトリのクローン
リポジトリを誤ってクローンする際の問題を避けるために、コマンドを実行するときは、実行エラーがないことがわかっている特定のブランチをクローンすることをお勧めします：
- Dockerのインストール → https://www.docker.com/get-started
上記のリンクにあるインストーラーのおかげで非常に簡単なプロセスであり、~/HuellaDigital/Backend/docker/localパスにあるdocker-compose.ymlファイルを起動するために非常に必要です
次に、Visual Studio CodeまたはIntelliJを使用してプロジェクトをデプロイするかどうかを決定する必要があります。私の場合は、2つの異なる視点を見ることに興味があり、プロジェクトのデプロイについてもっと学ぶために、両方のIDEで行うことを選択しました。
VISUAL STUDIO CODE
ここでは、要件セクションを少し拡張し、便利ないくつかの拡張機能を追加する必要があります：
- https://marketplace.visualstudio.com/items?itemName=Pivotal.vscode-spring-boot
- https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-spring-initializr
- https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-spring-boot-dashboard
- Visual Codeの拡張機能で「Java extension pack」を検索してインストールします
IntelliJ
IntelliJはVisual Codeより少し強力なので、拡張機能をインストールする必要はありません。プロジェクトを起動するために、プロジェクトを起動するために必要なコマンドを実行できるパッケージをインストールする必要があるだけです。
インストール
ここまでが軽くて簡単にインストールできるもので、今度は重要な部分です：
- JDKのインストール → https://www.oracle.com/java/technologies/javase-downloads.html
- MVNのインストール → http://maven.apache.org/download.cgi#Files（バイナリzipをダウンロード）
mavenからダウンロードしたフォルダーを解凍し、コピーして、Program Filesにmavenという名前のフォルダーを作成し、解凍したものを中に貼り付けます：
Windowsの検索で「システム環境変数の編集」と入力します。次に、右下の環境変数に移動します：
以下のような2つの変数を追加する必要があります：
それらを作成するには、「新規」をクリックして次のデータを入力するだけです：
変数値フィールドでは、「ディレクトリを参照」ボタンをクリックしてファイルエクスプローラーをナビゲートし、jdkの場所を選択する必要があります。
次に重要なこと（非常に注意して）path変数を次のように変更する必要があります：
これで、原則としてIntelliJでプロジェクトを実行するための基本的なコマンドを実行できるようになります：
- New terminal -> cd~/HuellaDigital/Backend/docker/local
- docker-compose up -d（Dockerコンテナを起動）
- cd ~/HuellaDigital/Backend
- mvn clean compile spring-boot:run
- cd ~/HuellaDigital/Frontend
- npm install
- npm run start
これで、バックエンドが実行され、フロントエンドが起動して、Webを閲覧し、バックエンドAPIにリクエストを送信できるようになります（今のところ、登録フォームに入力することしかできません）
また、Postmanやその他のリクエストツールを使用する場合も機能します：
（重要：POSTリクエストではTEXTではなくJSONを送信してください）
最終的にVisual Codeで行うことを選択した場合、インターフェイスは次のようなものに変わっているはずです：
私たちにとって本当に重要なのは、Spring-Boot Dashboardタブで、バックエンドが実行されているときに表示されます。前述のコマンドを実行すると、次のようになります：
何を学びましたか？
5分間の読書で要約できますが、システムにMavenがインストールされていない状態でコマンドを実行しようとしたときに発生したエラーに気付くまでにかなりの時間がかかりました。また、ある日は1人にとってはすべてがうまく機能し、他の人にとってはうまく機能しなかったため、バックエンドを起動するのに非常に苦労しました。お互いのエラーを見て、グループでそれらを修正しようとすることは、私の観点から個人的な発展にかなり貢献することです。
運が良くて最初からすべてを正しく行ったと想像しましょう。何を学びましたか？何もありません。しかし、あなたには失敗しない何かが他の人に失敗した場合、なぜ機能しないのかを複数の人が見ようとすることで、将来的に問題に1人で苦労し、節約できる時間を費やすことを防ぎます。
要約すると、自立することは私が学ぶ必要があると考える資質であり、早ければ早いほど良いです。
コメント