힘내 개요

이 항목에서는 배달 시스템 API의 필수적인 부분인 Git 사용의 기본 개념을 학습합니다.

힘내 사용: 개요

Git은 전달 시스템의 필수적인 부분이므로 아직 Git의 개념에 익숙하지 않은 모든 사용자는 Git 웹 사이트에서자세히 알아볼 것을 권장합니다 . 사용할 수 있는 편리한 Git치트 시트도 있습니다.

Delivery System API를 사용하려면 Git을 설치해야 하며 다음에서 설치할 수 있습니다. 힘내 웹 사이트 . 우리가 제공하는 명령 줄 예제는 일반적으로 작성된 그대로 직접 사용할 수 없지만 많은 자리 표시자가 사용되기 때문입니다. 다음을 환경 변수 또는 값으로 대체하십시오. 계정_ID , 리포지터리_이름 , 액세스_토큰 , 사용자 이름

힘내 사용: 승인

REST API와 달리 Git에서는 Brightcove 사용자 이름과 암호를 사용하는 기본 인증을 통해 한 가지 방법으로 만 권한을 부여 할 수 있습니다. 현재 Git에서 OAuth 액세스 토큰을 사용할 수 없습니다.

Git은 사용자 이름과 암호를 입력하라는 메시지를 표시하므로 아래 예제에서 인증에 대한 언급이 표시되지 않습니다.

깃: 저장소 생성 / 업데이트

Git이 설치되고 REST를 통해 생성 된 리포지토리를 사용하면 사용할 로컬 리포지토리 생성을 시작할 수 있습니다. 간단히 디렉터리를 만든 다음 git init명령을 사용하여 해당 디렉터리 내에서 Git을 초기화하여 만든 로컬 리포지토리입니다.

          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 push 출력에 나와있습니다. 저장소 URL에 대한 REST API 호출 내에서 모든 저장소의 기본 URL을 찾을 수도 있습니다. 모든 파일은 모든 사용자가 빠르게 볼 수 있도록 CDN에 저장됩니다.

자신 만의 완전 맞춤형 플레이어를 구축하는 경우 브라우저와 같은 일반적인 클라이언트 내에서 모든 파일에 대한 업데이트가 동시에 발생한다고 보장 할 수 없습니다. 따라서 전달 시스템 API 사용자는 업데이트 후 밀접하게 연결된 파일이 함께 요청되도록하는 버전 관리 전략을 사용하는 것이 좋습니다. 이를 달성하기위한 한 가지 전략은 기존 파일을 덮어 쓰지 않고 완전히 새로운 위치에서 업데이트하는 것입니다. 이것은 우리 서비스에 캐시 된 사본이있을 가능성이 없기 때문에 요청 된 파일이 원본 소스임을 강제합니다. 그러나 이러한 캐시되지 않은 복사본에 대한 처음 몇 개의 요청은 평소보다 오래 걸릴 것으로 예상해야합니다. 명확하게 말하면, 플레이어 관리 API를 사용하여 플레이어를 만들고 전달 시스템 API를 직접 사용하지 않는 경우 캐시 문제가 자동으로 처리되므로 이에 대해 걱정할 필요가 없습니다.

라이브 사이트에 업데이트가 반영되는 데 걸리는 총 시간은 여러 요인에 따라 다릅니다. 가장 중요한 요소에는 브라우저 캐싱과 에지 노드에서 삭제 요청을 완료하는 데 걸리는 시간이 포함됩니다. 일반적으로 리포지토리에 마지막으로 푸시한 시점부터 5분 이상 걸리지 않습니다. 이는 우리가 제공하는 파일이 기본적으로 브라우저에 5분 동안 캐시되도록 설정되어 있고 모든 엣지 노드를 지우는 데 평균 1분 정도 걸리기 때문입니다. 그러나 최대 서비스 부하에서는 제거 시간이 훨씬 더 길어질 수 있습니다 (최대 10 분). 최악의 시나리오에서는 모든 캐싱 계층을 지우고 업데이트가 마침내 적용되는 데 (여전히 이번 결정) 시간이 걸립니다. 삭제 요청이 실패하거나 시간이 초과되지 않고 콘텐츠를 새로 고치는 데 폴백 캐시 처리기가 필요하지 않는 한 이런 일이 발생해서는 안됩니다.

변경 사항보기

변경 후 수행 한 작업을보고 싶을 것입니다. gitk명령을 사용하여 이 작업을 수행할 수 있습니다. 직접 초기화 된 Git에서이 명령을 사용하면 작업을 보여주는 GUI가 나타납니다. 간단한 샘플은 다음과 같습니다.

gitk GUI

힘내 사용: 저장소 복제

Brightcove에서 이미 저장중인 저장소를 로컬 시스템에 복사 할 수 있습니다. Git 용어로이를 저장소 복제라고합니다. 이를 통해 조직의 다른 사람이 만든 저장소를 가져올 수있을뿐만 아니라 플레이어 관리 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 가이드를 다시 검토하여 유효한 액세스 토큰이 있는지 확인하세요.