다음은 Cloud 클라이언트 라이브러리 및 Google API 클라이언트 라이브러리를 모두 사용하는 경우, 최적의 성능과 최상의 경험을 얻는 데 도움이 되는 권장사항입니다.
클라이언트 객체 및 세션 재사용
동일한 라이브러리로 요청을 수행할 때 모든 요청마다 새 요청을 만드는 대신 가능하면 많은 요청에 대해 동일한 클라이언트 객체를 재사용해야 합니다. 동일한 인스턴스의 요청은 사용자 인증 정보 인스턴스를 공유합니다.
세션 클라이언트의 인스턴스에서 수행한 초기 요청은 인증, 승인, 액세스 토큰 생성을 수행합니다. 이 처리는 네트워크에서 발생하므로 몇 초가 걸릴 수 있습니다. 동일한 클라이언트 인스턴스에 대한 추가 호출 시 세션 클라이언트는 동일한 액세스 토큰이 유효하다면(일반적으로 1시간 동안) 이를 재사용합니다. 만료되면 세션 클라이언트가 액세스 토큰을 자동으로 새로 고칩니다. 최적의 성능을 위해 애플리케이션에서 수행한 모든 요청에 동일한 세션 클라이언트 인스턴스를 재사용하고 동일한 사용자 인증 정보 집합 아래에서 클라이언트가 필요에 따라 실행해야 하는 모든 요청에 액세스 토큰을 새로 고칠 수 있도록 허용해야 합니다.
또한 클라이언트 라이브러리에서 사용하는 일부 인증 전략에는 이와 관련된 비율 제한이 있습니다. 클라이언트의 각 인스턴스에는 고유한 사용자 인증 정보 캐시가 있기 때문에 짧은 시간 안에 너무 많이 만들면 비율 제한이 발생하여 라이브러리 요청이 인증에 실패할 수 있습니다.
프로덕션을 위한 종속 항목 고정
npm 또는 pip와 같은 패키지 관리자에서 라이브러리를 설치할 때 프로덕션 사용을 위해 내장된 버전 관리를 사용하여 버전을 고정하는 것이 중요합니다. 이렇게 하면 동일한 버전의 라이브러리가 빌드에 일관되게 사용됩니다. 이는 API 노출 영역이 변경될 수 있는 베타 클라이언트를 사용하려는 경우 특히 중요합니다. 라이브러리 패키지 문서의 관련된 라이브러리의 문서에서 이 내용을 설명합니다.
최신 소식 받기
Google Cloud의 기능과 API가 변경되면 클라이언트 라이브러리도 변경됩니다. 클라이언트 라이브러리는 종종 일일 업데이트 및 출시로 인해 변경됩니다. 가능한 최상의 지원 경험을 위해선 출시 버전을 최신 상태로 유지해야 합니다. 많은 라이브러리가 시맨틱 버전 관리를 지원하여 업그레이드의 작업량을 쉽게 파악할 수 있습니다. 성능이 저하되거나 문제가 발생하고 이전 버전의 클라이언트 라이브러리를 사용하는 경우 최신 버전의 모든 개선 사항을 활용할 수 있도록 업그레이드합니다.