サポート サポート問い合わせ先 | システムステータス システムステータス

Gitの概要

このトピックでは、デリバリーシステムAPIに不可欠であるGitの使い方の基本的な概念を学びます。

Gitの使用:概要

GItは、デリバリーシステムにおいて不可欠であり、その概念に精通していない全てのユーザーの皆様がGitのことをもっとGitのウェブサイトで学ぶことをお勧め致します。 GitのウェブサイトGitの便利メモ もございます。

デリバリーシステムAPIを使用するためには、Gitをインストールする必要があり、Gitのウェブサイトからインストールすることができます。 Gitのウェブサイト。 しかし、私たちが提供するコマンドラインの例は、通常そのまま使用することはできませんので、代わりにプレースホルダを使用しています。環境変数または値を次のように置き換えます。 ACCOUNT_ID, REPO_NAME, ACCESS_TOKEN, USERNAME

Gitを使う:権限を与える

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

Gitはユーザー名とパスワードの入力を促しますので、以下の例では認証についての言及はありません。

Git:リポジトリの作成/更新

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

          mkdir my_repo
          cd my_repo
          git init
          

レポが初期化された状態で、ブライトコーブサーバーにあるリモートレポジトリと紐づけることができます。そうすることで、お客様の変更をサーバーへ簡単に反映させることができます。

          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を使う:Push Repo

さまざまなファイルがプッシュされる場所の詳細は、の出力に示されています。 git pushとして出力されます。また、レポのURLへREST APIコールを実行することで、どのレポのベースURLも検索することができます。すべてのファイルはCDN上に保存されているため、すべてのユーザーがすばやく見ることができます。

独自にカスタマイズされたプレイヤーを構築する場合、ブラウザのような典型的なクライアント側で全てのファイルの更新が同時に実行されることは保証できません。したがって、デリバリーシステムAPIのユーザーがファイルの更新が実行された後に全てのファイルをまとめて要求することができるようなバージョン管理の方法を使用することを強く推奨いたします。このことを達成するための方法の一つは、既存のファイルを上書きするのではなく、全く新しい場所でファイル更新を行うことです。これにより要求されるファイルはブライトコーブに残っているキャッシュである可能性も無くなり、全てオリジナルファイルになります。これらのキャッシュされていないコピーの最初の数回の要求は、通常よりも長くかかることがあります。しかし、もし、直接デリバリーシステムAPIを使用せず、Player Management APIをしてプレイヤを作成するのであれば、このキャッシュの問題は処理済みであるため、心配する必要はありません。

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

変更内容の確認

変更した後は、あなたがしたことを確認したいでしょう。 これを行うには、 gitk コマンドを使用します。 あなたのGitでこのコマンドを直接使用すると、あなたの仕事を示すGUIが表示されます。 簡単なサンプルが次のように表示されます。

gitk GUI

Gitを使う:Clone repo

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

          git clone https://repos.api.brightcove.com/v1/accounts/$ACCOUNT_ID/repos/$REPO_NAME/$ACCESS_TOKEN

エラー応答:Git

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

  • 存在しないレポジトリを呼び出そうとすると、通常次のようなメッセージが表示されます。 git-upload-pack not found:サーバ上でgit update-server-infoを実行しましたか?。 レポURLが正しいことを確認してください。
  • あなたのコールが認証されていない、もしくは権限が与えられていない場合は、通常、パスワードの入力を求められます。 このパスワード入力のウィンドウを閉じて、有効なアクセストークンを持っていることを確認するために再度OAuthガイドを参照してください。

ページの最終更新日:12年2020月XNUMX日