Git credentials
===============

このページでは、認証が必要なGitリポジトリのクローンを作成する方法について説明します。

これは、 ``postgres_git_url``
を :ref:`install Postgres from source <Postgres source installation>` または :ref:`use `install_from_source` <Installing from source>` に変更して拡張機能をコンパイルおよびインストールする場合に必要になる場合があります。

資格情報をターゲットインスタンスのディスクに書き込まずに認証するには、2つのオプションがあります。

-  ``ssh://``
   リポジトリの場合、SSHキーをローカルssh-agentに追加できます。
   ``--install-from-source`` config.ymlの\ ``forward_ssh_agent: yes``
   を使用する場合、エージェント転送はデフォルトで有効になります。

-  ``https://`` リポジトリの場合、\ ``tpaexec deploy``
   を実行する前に環境で\ ``export TPA_GIT_CREDENTIALS=username:token``
   を実行できます。

..  Note::
   When deploying to Docker on macOS, you should use only `https://`  repository URLs because Docker containers cannot be accessed by ssh from the host in this environment.

SSHキー認証
-----------

SSHリポジトリのクローンを作成しており、SSHキーペア\ ``id_example``
および\ ``id_example.pub``
がある場合、SSHエージェント転送を使用してターゲットインスタンスで認証します。

-  **``ssh-agent`` をローカルで実行する必要があります**
   。デスクトップ環境がこれをまだ設定していない場合は、ほとんどの場合-``pgrep ssh-agent``
   が実行されているかを確認します ``ssh-agent bash``
   を実行してエージェントを有効にした新しいシェルを一時的に起動し、そのシェルから\ ``tpaexec deploy``
   を実行します。

-  ``ssh-add /path/to/id_example``
   プライベートキーファイルを使用して、必要なキーをエージェントに追加します*\*

-  ``tpaexec provision``
   の前にconfig.ymlのトップレベルで\ ``forward_ssh_agent: yes``
   を設定することにより、SSHエージェント転送を有効にします*\*。
   ``--install-from-source``
   を使用する場合、これはデフォルトで行われます。

展開中に、エージェントに追加したキーは、転送されたエージェント接続を介してリモートサーバーへの認証に利用できるようになります。

SSHエージェント転送は注意して使用し、できればこの目的のために専用に生成された使い捨てキーペアを使用します。ターゲットサーバー上のエージェントのUnixドメインソケットにアクセスする権限を持つユーザーは、他のサーバーへの認証中にエージェントを組み込んでなりすましができます。

HTTPSのユーザー名/パスワード認証
--------------------------------
