【第2回】 2022年5月19日

GitとGitHubの使い方・ Herokuの使い方

0. 準備

どうにかして（PostgreSQLうんぬんは無視してでも） oTree をインストールする．
- WindowsにPythonを直接インストールして，pipで oTree を入れる．
  https://otree.readthedocs.io/en/latest/install-windows.html#install-windows
  - 【フリーライド】立命館竹内研長瀬さんのチュートリアル動画が参考になります．
    「#2 oTree Windowsでのインストール」（動画リンクは竹内研Slack内を検索してください．）
- 頑張ってWSL2を使い，Ubuntu環境を用意してから...
  1. WSL2のインストール
  2. Ubuntuで oTree を動かす
- Macの場合はまずhomebrewをインストールしてから...
  - 【フリーライド】立命館竹内研長瀬さんのチュートリアル動画が参考になります．
    「#2 oTree Macでのインストール」（動画リンクは竹内研Slack内を検索してください．）

Herokuのアカウントを作成． https://signup.heroku.com/login
GitHubのアカウントを作成． https://github.com/signup

1. GitとGitHubを使うメリット

Gitはローカル環境においてバージョン管理を行うソフトウェア．
- ファイルを上書き保存していくと開発の過程が記録されない．
- ファイル名に枝番をつける的な手動バージョン管理ではしっちゃかめっちゃかに．
- Gitでシステマティックにバージョン管理をしよう！
GitHub（クラウド）にローカルのGitで管理しているリポジトリをアップロードできる．
- クラウドを介して複数人での開発が効率化できる．
- 複数のマシンで1つのプロジェクトを管理できる．
- GitHubはホスティングサービスとしても有用．
- GitHubとHerokuとの連携も便利 ~~（2022年5月現在使えないけど）~~ ．
- （GitHubのほかにGitLabもある．）
研究活動でのGitHubの活用例
- 国里愛彦ラボ https://kunisatolab.github.io/main/how-to-github.html

2. GitとGitHubの使い方

参考資料

公式の教科書 https://git-scm.com/book/en/v2
名城大理工学部大原研 https://www1.meijo-u.ac.jp/~kohara/cms/technicalreport
ドットインストール git入門 https://dotinstall.com/lessons/basic_git （無料で視聴可能）
Webでも書籍でも，Gitに関するドキュメントは大量に存在する．

初期設定

Gitのインストール
- Windowsに直接Pythonを入れて oTree を動かす場合，Gitのインストーラーを https://gitforwindows.org/ からダウンロードしてインストールする．
  - 参考 https://www.curict.com/item/60/60bfe0e.html
- Ubuntuを使う場合，以下のコマンドでインストール．
```
sudo apt update
sudo apt install git
```
- Macを使う場合，Xcode Command Line Toolsが導入済みならばすでに git コマンドは使えるはず．あるいはhomebrewで入れる．
GitHubのアカウントを作る． https://github.com/signup
GitHubで登録しているユーザー名とメールアドレスをローカルで設定（コミット毎にユーザー名とメールアドレスが記録される）．
```
git config --global user.email "xxxxxxxx@example.com"
git config --global user.name "namaenamae"
```
- リポジトリを Public にする場合，設定したメールアドレスも公開される．公開したくない場合はコミット用のかりそめのメールアドレスを代わりに設定する必要がある． https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address
GitHubへSSHで接続できるようにする．
https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh
1. SSHの鍵を作る．オプション-C以下でGitHubで登録したメールアドレスを陽に指定する．
```
ssh-keygen -t ed25519 -C "xxxxxxxx@example.com"
```
  - 鍵の場所は ~/.ssh ．
  - 鍵にパスフレーズは不要（設定するなら鍵をssh-agentに登録する必要あり）．
2. 公開鍵（*.pub）をGitHubに登録．
  https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account
  - cat ~/.ssh/鍵ファイル名.pub で公開鍵の中身を表示し，コピーしておく．
  - GitHub https://github.com/settings/keys をブラウザで開き，「New SSH key」をクリックし，コピーした公開鍵の中身をペーストする．
3. ~/.ssh/config にSSH鍵関係の情報を追記．
```
Host github.com
       IdentityFile ~/.ssh/鍵ファイル名
       User git
```
4. アクセスできるか確認．
```
ssh -T git@github.com
```
5. すでにGitHubに（プライベート）リポジトリがあればクローンしてみる．
```
git clone git@github.com:namaenamae/rrrrrrrrrr.git
```

基本的な手順

https://learnxinyminutes.com/docs/git/

（初回のみ）初期化... 作業ディレクトリに移動して，そのディレクトリをGitリポジトリとして設定（.gitディレクトリができる）．
```
git init
```
（初回のみ）ブラウザでGitHubを開き，作業ディレクトリと同名のリポジトリを作成．リモートリポジトリを設定．
```
git remote add origin git@github.com:myname/myrepository.git
```
作成・編集したファイルをステージングエリアに追加する．たとえばディレクトリ全体なら...
```
git add .
```
「キリのよいところで」コミットする．
```
git commit -m "first commit"
```
- オプション -m 以下を指定しない場合はVimかnanoが起動するので，それでコメントを書く．
ある程度コミットが溜まったら，GitHubへプッシュ（アップロード）．
```
git push -u origin master
```
- オプション -u は2回目以降では不要．
- ブランチ名はデフォルトで masterになっているはずだが要確認．
  GitHubはポリコレ的にデフォルトブランチ名を main に変えることを勧めている．
明くる日作業を再開するときには，それまでの（他人の）変更分をダウンロードする．
```
git pull origin master
```
1日の作業の流れ: pull -> ( 編集 -> add -> commit ) の繰り返し -> push

ブランチの操作

ブランチを切る（たとえば開発用にmyname/devなるブランチを作ってそこに切り替える）．
```
git checkout -b myname/dev
```
ブランチを切り替える（たとえばmasterに戻る）．
```
git checkout master
```
masterブランチにmyname/devブランチの変更分をマージするには，git checkout masterした後，
```
git merge myname/dev
```
↑ のように merge でマージできるが，節目にはGitHubでプルリクエストしてマージ分を誰かにレビューしてもらった方が良い．

3. Herokuの使い方

詳しくはこちら

デプロイの方法

アドオンと環境変数の設定

results matching ""

No results matching ""