Summary: Guide to setting up the GakuNin RDM development environment on Amazon EC2 概要: Amazon EC2 に GakuNin RDM の開発環境を構築する手引き
- Version / 版: 0.2 — 2026-11-06. Learned: a glossary term is only explained for the reader when its note and REF-01 link sit at the first prose use, counting lower-case and plural forms, so first-use notes with links were added in both halves (SPEC-06 §3). / 用語注と REF-01 へのリンクは、小文字や複数形も含めた本文の初出に置かなければ読者に届かないと分かったため、英和両方の初出にリンク付きの用語注を補った(SPEC-06 §3)。
- Version / 版: 0.1 — 2026-11-05
- Normative for:
docs/guides/ec2/ - Related: SPEC-06 Documentation Conventions
This guide shows how to set up the GakuNin RDM (GakuNin is Japan's academic network for logging in with a university account; see REF-01) development environment on an Amazon EC2 instance.
- An AWS account
- Basic familiarity with Linux command-line tools
- SSH access to your EC2 instance
- Launch an EC2 instance (Ubuntu 22.04 or Amazon Linux 2 recommended)
- Install Docker (the tool that builds images and runs containers; see REF-01) and Docker Compose (a tool that starts many containers together from one file; see REF-01)
- Clone this repository
- Run
./installer/install.sh --yes - Configure your EC2 security group to allow HTTP (port 80) and SSH (port 22)
- Open http://localhost:5000 (localhost means your own computer; see REF-01) in your browser
This command is available from milestone M2.
The legacy EC2 setup instructions are kept verbatim in README.legacy.md for reference and will be rewritten per milestone.
このガイドは、Amazon EC2 上に GakuNin RDM(GakuNin=学認。大学のアカウントでログインするための日本の学術ネットワーク。REF-01)の開発環境を構築する方法を示します。
- AWS アカウント
- Linux コマンドラインツールの基本的な使い方の理解
- EC2 インスタンスへの SSH アクセス
- EC2 インスタンスを起動する(Ubuntu 22.04 または Amazon Linux 2 を推奨)
- Docker(イメージを作りコンテナを動かす道具。REF-01)と Docker Compose(一つのファイルから多くのコンテナをまとめて起こす道具。REF-01)をインストールする
- このリポジトリを clone する
./installer/install.sh --yesを実行する- EC2 のセキュリティグループで HTTP (ポート 80) と SSH (ポート 22) を許可する
- ブラウザで http://localhost:5000(localhost は自分の計算機のこと。REF-01)を開く
このコマンドは M2 マイルストーンから利用可能です。
過去の EC2 へのセットアップ手順は、参考のために README.legacy.md にそのまま残しており、マイルストーンごとに書き直す予定です。
| Term | English note | 日本語注 |
|---|---|---|
| EC2 (Elastic Compute Cloud) | Amazon's service to run virtual computers on the internet. | アマゾンがインターネット上で仮想コンピュータを実行するサービス。 |
| Security group | A virtual firewall that controls traffic to your EC2 instance. | EC2 インスタンスへのアクセスを制御する仮想のファイアウォール。 |
| SSH (Secure Shell) | A secure way to log in to your remote computer and run commands. | リモートのコンピュータに安全にログインしてコマンドを実行する方法。 |