원격 구성 템플릿 및 버전 관리

Firebase 콘솔

매개변수 탭의 오른쪽 상단에 표시된 '시계' 아이콘을 선택합니다. 그러면 변경 내역 페이지가 열리고 저장된 모든 템플릿 버전이 오른쪽에 있는 목록 메뉴에 나열됩니다.

저장된 각 버전에 표시되는 세부정보에는 변경사항이 Console, REST API, 롤백 중 어디에서 시작되었는지 또는 템플릿 강제 저장으로 변경사항이 추가로 적용되었는지 여부에 관한 정보가 포함되어 있습니다.

Firebase CLI

firebase remoteconfig:versions:list

반환되는 버전 수를 제한하려면 --limit 옵션을 사용합니다. 모든 버전을 가져오려면 '0'을 전달합니다.

Node.js

function listAllVersions() {
  admin.remoteConfig().listVersions()
    .then((listVersionsResult) => {
      console.log("Successfully fetched the list of versions");
      listVersionsResult.versions.forEach((version) => {
        console.log('version', JSON.stringify(version));
      });
    })
    .catch((error) => {
      console.log(error);
    });
}

자바

ListVersionsPage page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get();
while (page != null) {
  for (Version version : page.getValues()) {
    System.out.println("Version: " + version.getVersionNumber());
  }
  page = page.getNextPage();
}

// Iterate through all versions. This will still retrieve versions in batches.
page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get();
for (Version version : page.iterateAll()) {
  System.out.println("Version: " + version.getVersionNumber());
}

REST

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig:listVersions

Firebase 콘솔

기본적으로 변경 내역 탭의 세부정보 창에는 현재 활성 템플릿이 표시됩니다. 목록에서 다른 버전에 대한 세부정보를 보려면 오른쪽 메뉴에서 해당 버전을 선택하세요.

선택되지 않은 버전의 컨텍스트 메뉴로 마우스를 이동하고 선택한 버전과 비교를 선택하여 현재 선택한 버전 및 다른 저장된 버전 간의 차이를 자세히 확인할 수 있습니다.

Firebase CLI

firebase remoteconfig:get -v VERSION_NUMBER

필요에 따라 -o, FILENAME을 사용하여 지정된 파일에 출력을 작성할 수 있습니다.

Node.js

인수 없이 getTemplate()을 전달하여 템플릿의 최신 버전을 검색하거나 getTemplateAtVersion()을 사용하여 특정 버전을 검색할 수 있습니다.

// Get template version: 6
admin.remoteConfig().getTemplateAtVersion('6')
  .then((template) => {
    console.log("Successfully fetched the template with ETag: " + template.etag);
  })
  .catch((error) => {
    console.log(error);
  });

자바

Template template = FirebaseRemoteConfig.getInstance().getTemplateAtVersionAsync(versionNumber).get();
// See the ETag of the fetched template.
System.out.println("Successfully fetched the template with ETag: " + template.getETag());

REST

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig?version_number=6

URL 매개변수 ?version_number는 GET 작업에만 유효하며 업데이트의 버전 번호를 지정하기 위해 사용할 수 없습니다. ?version_number 매개변수를 사용하지 않는 유사한 get 요청은 현재 활성 상태인 템플릿을 검색합니다.

Firebase 콘솔

롤백이 가능한 이전 템플릿 버전의 경우 변경 내역 페이지 오른쪽 상단에 해당 버전으로 롤백하는 옵션 버튼이 표시됩니다. 해당 버전으로 롤백하고 모든 앱과 사용자에 대해 해당 값을 즉시 사용하려는 경우에만 이 버튼을 클릭하고 확인합니다.

Firebase CLI

firebase remoteconfig:rollback -v VERSION_NUMBER

Node.js

// Roll back to template version: 6
admin.remoteConfig().rollback('6')
  .then((template) => {
    console.log("Successfully rolled back to template version 6.");
    console.log("New ETag: " + template.etag);
  })
  .catch((error) => {
    console.log('Error trying to rollback:', e);
  })

자바

try {
  Template template = FirebaseRemoteConfig.getInstance().rollbackAsync(versionNumber).get();
  System.out.println("Successfully rolled back to template version: " + versionNumber);
  System.out.println("New ETag: " + template.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Error trying to rollback template.");
    System.out.println(rcError.getMessage());
  }
}

REST

저장된 Remote Config 템플릿으로 롤백하려면 커스텀 메서드 :rollback과 요청 본문에서 적용할 특정 버전으로 HTTP POST를 실행합니다. 예를 들면 다음과 같습니다.

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -H "Content-Type: application/json" -X POST https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig:rollback -d '{"version_number": 6}'

응답에는 현재 저장된 활성 템플릿의 콘텐츠와 새 버전 메타데이터가 포함됩니다.

Firebase 콘솔

1. Remote Config 파라미터 또는 조건 탭에서 more_vert메뉴를 열고 현재 구성 파일 다운로드를 선택합니다.
2. 메시지가 표시되면 구성 파일 다운로드를 클릭하고 파일을 저장할 위치를 선택한 후 저장을 클릭합니다.

Firebase CLI

firebase remoteconfig:get -o filename

Node.js

function getTemplate() {
  var config = admin.remoteConfig();
  config.getTemplate()
      .then(function (template) {
        console.log('ETag from server: ' + template.etag);
        var templateStr = JSON.stringify(template);
        fs.writeFileSync('config.json', templateStr);
      })
      .catch(function (err) {
        console.error('Unable to get template');
        console.error(err);
      });
}

자바

Template template = FirebaseRemoteConfig.getInstance().getTemplateAsync().get();
// See the ETag of the fetched template.
System.out.println("ETag from server: " + template.getETag());

REST

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -o filename

이 명령어는 JSON 페이로드를 파일 하나에 출력하고, 헤더(ETag 포함)를 별도의 headers 파일에 출력합니다.

Node.js

function validateTemplate(template) {
  admin.remoteConfig().validateTemplate(template)
      .then(function (validatedTemplate) {
        // The template is valid and safe to use.
        console.log('Template was valid and safe to use');
      })
      .catch(function (err) {
        console.error('Template is invalid and cannot be published');
        console.error(err);
      });
}

자바

try {
  Template validatedTemplate = FirebaseRemoteConfig.getInstance()
          .validateTemplateAsync(template).get();
  System.out.println("Template was valid and safe to use");
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Template is invalid and cannot be published");
    System.out.println(rcError.getMessage());
  }
}

REST

게시 요청에 URL 매개변수 ?validate_only=true를 추가하여 템플릿 업데이트의 유효성을 검사합니다.

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig?validate_only=true -d @filename

템플릿의 유효성 검사에 성공하면 curl 명령어가 제출한 JSON 템플릿을 반환하고 저장된 headers 파일에 HTTP/2 상태 200과 접미사 -0가 있는 업데이트된 ETag가 표시됩니다. 템플릿이 검증되지 않은 경우 JSON 응답에 유효성 검사 오류가 표시되고 headers 파일에는 200이 아닌 응답이 포함됩니다(ETag 없음).

Firebase 콘솔

1. Remote Config 파라미터 또는 조건 탭에서 more_vert메뉴를 열고 파일에서 게시하기를 선택합니다.
2. 메시지가 표시되면 찾아보기를 클릭하고 게시할 Remote Config 파일로 이동하여 선택한 다음 선택을 클릭합니다.
3. 파일은 유효성 검사를 거치게 되며, 성공하면 게시를 클릭하여 앱과 사용자가 즉시 구성을 사용할 수 있도록 할 수 있습니다.

Node.js

function publishTemplate() {
  var config = admin.remoteConfig();
  var template = config.createTemplateFromJSON(
      fs.readFileSync('config.json', 'UTF8'));
  config.publishTemplate(template)
      .then(function (updatedTemplate) {
        console.log('Template has been published');
        console.log('ETag from server: ' + updatedTemplate.etag);
      })
      .catch(function (err) {
        console.error('Unable to publish template.');
        console.error(err);
      });
}

자바

try {
  Template publishedTemplate = FirebaseRemoteConfig.getInstance()
          .publishTemplateAsync(template).get();
  System.out.println("Template has been published");
  // See the ETag of the published template.
  System.out.println("ETag from server: " + publishedTemplate.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Unable to publish template.");
    System.out.println(rcError.getMessage());
  }
}

REST

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -d @filename

curl 명령어의 경우 파일 이름 앞에 '@' 문자를 사용하여 콘텐츠를 지정할 수 있습니다.

REST

curl --compressed -D headers -H "Authorization: Bearer token -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:downloadDefaults?format=file_format'

다운로드할 파일 형식에 따라 XML, PLIST, JSON를 format 값으로 사용합니다.

Firebase 콘솔

1. 매개변수 탭에서 more_vert메뉴를 열고 기본값 다운로드를 선택합니다.
2. 메시지가 표시되면 다운로드할 파일 형식에 해당하는 라디오 버튼을 클릭한 다음 파일 다운로드를 클릭합니다.