Gitの概要

このトピックでは、Delivery SystemAPIの重要な部分であるGitの使用の基本的な概念を学習します。

Gitを使う:概要

Gitは配信システムの重要な部分であり、Gitの概念にまだ精通していないすべてのユーザーに詳細を学ぶことをお勧めしますGitのWebサイト。便利なものもありますGitチートシート使用するためにそこに。

Delivery System APIを使用するには、Gitをインストールする必要があります。 GitのWebサイト。ここで紹介するコマンドラインの例は、通常、記述どおりに直接使用することはできませんが、多くのプレースホルダーが使用されているためです。環境変数または値を次のように置き換えます。 ACCOUNT_ID, REPO_NAME, アクセストークン, ユーザー名

Gitを使う:承認する

REST APIとは異なり、Gitでは1つの方法しか承認できません。それは、Brightcoveのユーザー名とパスワードを使用した基本認証によるものです。現在、GitでOAuthアクセストークンを使用することはできません。

Gitはユーザー名とパスワードの入力を求めるプロンプトを表示するはずなので、以下の例では認証についての言及はありません。

ギット：リポジトリの作成/更新

Gitをインストールし、RESTを介してリポジトリを作成すると、使用するローカルリポジトリの作成を開始できます。ディレクトリを作成し、そのディレクトリ内でGitを初期化するだけで作成されたローカルリポジトリgit initコマンド。

          mkdir my_repo
          cd my_repo
          git init

リポジトリが初期化されたら、Brightcoveシステムのリモートリポジトリに関連付けて、変更をサーバーに簡単にプッシュできるようにします。

          git remote add origin https://repos.api.brightcove.com/v1/accounts/[ACCOUNT_ID]/repos/[REPO_NAME]

次に、ローカルリモートのファイルを好きなように追加、編集、または削除できます。その後、通常のGitコマンドを使用してリモートリポジトリを更新できます。

          git add -A
          git commit 'Changing stuff'
          git push

Gitを使う:プッシュリポジトリ

さまざまなファイルがプッシュされる場所の詳細は、の出力に示されています。 git push。また、リポジトリURLへのRESTAPI呼び出し内のリポジトリのベースURLを見つけることもできます。すべてのファイルはCDNに保存されるため、すべてのユーザーがすばやく表示できます。

独自の完全にカスタムのプレーヤーを構築している場合、ブラウザなどの一般的なクライアント内ですべてのファイルの更新が同時に行われることを保証できないことに注意してください。したがって、配信システムAPIのユーザーは、更新が行われた後に密結合ファイルが一緒に要求されるようにするバージョン管理戦略を使用することを強くお勧めします。これを実現するための1つの戦略は、既存のファイルを上書きするのではなく、まったく新しい場所で更新を行うことです。これにより、サービスにキャッシュされたコピーが存在する可能性がないため、要求されたファイルが元のソースであることが強制されます。ただし、これらのキャッシュされていないコピーに対する最初のいくつかの要求には、通常よりも時間がかかることが予想されます。明確にするために、Player Management APIを使用してプレーヤーを作成し、配信システムAPIを直接使用しない場合は、キャッシュの問題が自動的に処理されるため、これについて心配する必要はありません。

ライブサイトに反映された更新を確認するのにかかる合計時間は、いくつかの要因によって異なります。最も重要なのは、これらの要因には、ブラウザーのキャッシュと、エッジノードからのパージ要求を完了するのにかかる時間が含まれます。通常、最後にリポジトリにプッシュしてから5分以内で完了します。これは、提供するファイルがデフォルトでブラウザに5分間キャッシュされるように設定されており、すべてのエッジノードがクリアされるのに平均で約1分しかかからないためです。ただし、サービス負荷がピークに達すると、パージ時間ははるかに長くなる可能性があります（最大10分）。最悪のシナリオでは、すべてのキャッシングレイヤーがクリアされ、更新が最終的に公開されるまでに（まだこの時間を決定します）かかります。パージ要求が失敗するかタイムアウトになり、コンテンツを更新するためにフォールバックキャッシュハンドラーが必要にならない限り、これは発生しないはずです。

変更を表示する

変更を加えた後、あなたはおそらくあなたが何をしたかを見たいと思うでしょう。あなたはを使用してこれを行うことができますgitk指図。直接初期化されたGitでこのコマンドを使用すると、作業内容を示すGUIが表示されます。簡単なサンプルは次のように表示されます。

Gitを使う:クローンリポジトリ

Brightcoveによってすでに保存されているリポジトリをローカルシステムにコピーできます。Gitの用語では、これはリポジトリのクローン作成として知られています。これにより、組織内の他の誰かが作成したリポジトリを取得できるだけでなく、Player Management APIが作成したリポジトリを取得することもできます。

          git clone https://repos.api.brightcove.com/v1/accounts/{account_id}/repos/$REPO_NAME/$ACCESS_TOKEN

エラー応答：ギット

Git呼び出しのエラー応答は、Gitクライアントがサポートできるものに限定されます。

存在しないリポジトリを呼び出そうとすると、通常、次のメッセージが表示されます。 git-upload-packが見つかりません：サーバーでgit update-server-infoを実行しましたか？。リポジトリのURLが正しいことを確認してください。
通話を認証または承認できない場合は、通常、パスワードの入力を求められます。このパスワードリクエストを終了し、OAuthガイドをもう一度確認して、有効なアクセストークンがあることを確認してください。