第3編GitHubを使った前期準備

5304 ワード

3.1使用前の準備
  • GitHubアカウント
  • の作成
    まずGitHubアカウント、GitHub公式サイトを作成する必要があります.
  • 設定SSH Key
  • GitHubに既存倉庫が接続されている場合の認証は,SSHを用いた公開鍵認証方式により行われる.公開鍵認証に必要なSSH Keyを作成し、GitHubに追加します.
    次のコマンドを実行してSSH Keyを作成します.
    $ ssh-keygen -t rsa -C "[email protected]"
    Generating public/private rsa key pair.
    Enter file in which to save the key
    (/Users/your_user_directory/.ssh/id_rsa):     
    Enter passphrase(empty for no passphrase):     
    Enter same passphrase again:       

    [email protected]」の部分は、アカウント作成時に使用するメールアドレスに書き換えてください.パスワードは認証時に入力する必要がありますので、複雑度が高く記憶しやすい組み合わせを選択してください.
    パスワードを入力すると、次の結果が表示されます.
    Your identification has been saved in /c/Users/Administrator/.ssh/id_rsa.
    Your public key has been saved in /c/Users/Administrator/.ssh/id_rsa.pub.
    The key fingerprint is:
    SHA256:9gQCLiJSs0RaiVajx+sq1TsGLcszfCbyquIH/hVdd1s [email protected]
    The key's randomart image is:
    +---[RSA 2048]----+
    |..=o.            |
    |o*oo..           |
    |*.ooo . .. . . E |
    |=o+o. ..... . o  |
    |.+.= . .S .  .   |
    | .B o .. o       |
    |.=.= o    .      |
    |+.*.=            |
    |*oo= .           |
    +----[SHA256]-----+
    

    ただし、id_rsaファイルはプライベートキー、id_rsa.pubは公開鍵です.
  • 公開鍵
  • を追加
    GitHubに公開鍵を追加し,今後はプライベート鍵で認証できるようになる.
    右上の口座設定ボタン(Settings)をクリックし、SSH and GPG keysメニューを選択すると、TitleとKeyの2つの入力ボックスが表示されます.Titleに適切なキー名を入力します.Key部分はid_を貼り付けてくださいrsa.pubファイルの内容.id_rsa.pubの内容は、次の方法で表示できます.
    $ cat ~/.ssh/id_rsa.pub
    ssh-rsa         [email protected]

    追加に成功すると、アカウントを作成するときに使用するメールボックスに「公開鍵の追加が完了しました」というメッセージが表示されます([GitHub]A new public key was added to your account).
    以上の設定が完了すると、手に持っているプライベートキーでGitHubと認証や通信が可能になります.試してみましょう
    $ ssh -T [email protected]
    The authenticity of host 'github.com (192.32.254.132)' can't be established.
    RSA key fingerprint is SHA256:nThbg6kyjpJWGl7E1hGOCsdRobTxdCaARLviKw6E5SY8.
    Are you sure you want to continue connecting (yes/no)? yes
    Warning: Permanently added 'github.com,192.34.233.212' (RSA) to the list of known hosts.
    Enter passphrase for key '/c/Users/Administrator/.ssh/id_rsa':
    Hi harrytsz! You've successfully authenticated, but GitHub does not provide shell access.
    (            !)
    
  • 倉庫の作成
  • 実際に公開された倉庫を作成します.右上隅のツールバーのNew repositoryアイコンをクリックして、次の図のように新しい倉庫を作成します.
    Repository name:Repository nameバーに倉庫の名前を入力します.
    Description:Descriptionバーでは、倉庫の説明を設定できます.このバーは必須ではなく、空にすることができます.
    Public、Private:この欄でPublicまたはPrivateを選択できます.通常はデフォルトのPublicで公開倉庫が作成され、倉庫内のすべての内容が公開されます.Privateを選択すると、非公開の倉庫を作成できます.ユーザーはアクセス権を設定できますが、このサービスは有料です.
    Initialize this repository with a README:このオプションにフックをかけると、GitHubは自動的に倉庫を初期化し、READMEファイルを設定し、ユーザーがすぐにこの倉庫をcloneできるようにします.GitHubに既存のGit倉庫を追加したい場合は、チェックせずに手動でプッシュすることをお勧めします.
    Add.gitignore:下の左側のドロップダウンメニューは非常に便利で、初期化時に自動的に生成することができます.gitignoreファイル.この設定はGit倉庫でバージョン管理を行う必要のないファイルを記録するのに役立ちます.gitignoreファイルでは、フレームワークに基づいて設定するたびに面倒が省けます.ドロップダウンメニューには主な言語とフレームが含まれており、今後使用する言語を選択すればよい.
    Add a license:右側のドロップダウンメニューで、追加するライセンスプロトコルファイルを選択できます.このウェアハウスに含まれるコードがライセンス契約を確定している場合は、ここで選択します.その後、ライセンス契約の内容を含むLICENSEファイルが自動的に生成され、倉庫の内容を示すライセンス契約が生成されます.
    入力選択が完了したら、Create repositoryボタンをクリックして倉庫の作成を完了します.
  • 接続倉庫
  • 次のURLは、作成したばかりの倉庫のページです.
    https://github.com/ユーザー名/Hello-world
    README.md:初期化時に生成する、README.mdファイルの内容は倉庫のトップページに自動的に表示されます.したがって、このファイルには、本倉庫に含まれるソフトウェアの概要、使用プロセス、ライセンス契約などの情報が表示されるのが一般的です.
  • 公開コード
  • clone既存倉庫:次に、既存倉庫にコードを追加して公開してみます.まず、既存の倉庫cloneを身近な開発環境に移行します.cloneで指定したパスは次の図を参照してください.
    $ git clone [email protected]:harrytsz/Hello-World.git
    Cloning into 'Hello-World'...
    Enter passphrase for key '/c/Users/Administrator/.ssh/id_rsa':
    warning: You appear to have cloned an empty repository.
    
    $ cd Hello-World
    

    GitHubに設定されている公開鍵のパスワードを入力するように要求されます.認証に成功すると、倉庫はcloneによって倉庫名の後のディレクトリに格納されます.公開したいコードをこの倉庫に提出してGithubの倉庫にpushすると、コードが公開されます.
  • 記述コード
  • ここではhelloを作成しますworld.phpファイルは、「Hello World!」を出力するために使用されます.

    ハローのせいでworld.phpファイルはまだGit倉庫に追加されていないので、Untracked filesとして表示されます.
  • 提出
  • hello_world.phpは倉庫にコミットされます.これにより、このファイルはバージョン管理システムの管理下に入ります.今後の変更管理はGitに任せる.
    $ git add hello_world.php
    
    $ git commit -m "Add hello world script by php"
    [master (root-commit) 5f35f2d] Add hello world script by php
     1 file changed, 3 insertions(+)
     create mode 100644 hello_world.php
    

    git addコマンドでファイルを一時保存領域に追加し、git commitコマンドでコミットします.
    追加に成功するとgit logコマンドでコミットログを表示できます.
    $ git log
    commit 5f35f2df09c4979f4ecf2250498ba5dddf499c87 (HEAD -> master)
    Author: harrytsz <[email protected]>
    Date:   Thu Aug 2 16:58:18 2018 +0800
    
        Add hello world script by php
    
  • push
  • を行う.
    その後pushを実行するとGitHub上の倉庫が更新されます.
    $ git push
    Enter passphrase for key '/c/Users/Administrator/.ssh/id_rsa':
    Enumerating objects: 3, done.
    Counting objects: 100% (3/3), done.
    Writing objects: 100% (3/3), 258 bytes | 258.00 KiB/s, done.
    Total 3 (delta 0), reused 0 (delta 0)
    To github.com:harrytsz/Hello-World.git
     * [new branch]      master -> master
    

    これでコードはGitHubで公開された.実際に接続してみてはいかがでしょうかhttp://github.com/ユーザー名/Hello-worldを確認してください.
    #以上の内容はすべて《GitHub入門と実践》に抜粋した.