From d7b41f53610c3438229694936201212613444a13 Mon Sep 17 00:00:00 2001 From: jasonborg <48138260+jasonborg@users.noreply.github.com> Date: Thu, 6 Oct 2022 14:39:46 -0400 Subject: [PATCH] chore: release 3.0 (#37) * Update README with section on firebase backend * Bump version number to 3.0 --- README.md | 35 +++++++++++++------ .../debuglets/java/GcpDebugletVersion.java | 4 +-- 2 files changed, 27 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index a19b8b82..fb80ccd7 100644 --- a/README.md +++ b/README.md @@ -69,14 +69,6 @@ Note that the build script assumes some dependencies. To install these dependencies, run this command: -**On Debian 8:** - -```shell -sudo apt-get -y -q --no-install-recommends install \ - curl gcc build-essential libssl-dev unzip openjdk-7-jdk \ - cmake python maven -``` - **On Debian 9:** ```shell @@ -227,9 +219,8 @@ supports it. Either download the pre-packaged agent from https://storage.googleapis.com/cloud-debugger/compute-java/debian-wheezy/cdbg_java_agent_service_account.tar.gz or the locally built `cdbg_java_agent_service_account.tar.gz` -To use the service account credentials add these system properties: +To use the service account credentials add this system property:
--Dcom.google.cdbg.auth.serviceaccount.enable=true
 -Dcom.google.cdbg.auth.serviceaccount.jsonfile=/opt/cdbg/gcp-svc.json
 
@@ -300,3 +291,27 @@ used in an expression as `MainKt.getGreeting()` Companion object methods can be accessed by qualifying them with the `Companion` keyword. For instance, the `welcome` function above can be used in an expression as `Main.Companion.welcome()` + +### Experimental Firebase Realtime Database Backend + +This functionality is available for release 3.0 onward of this agent. + +The agent can be configured to use Firebase Realtime Database as a backend +instead of the deprecated Cloud Debugger service. If the Firebase backend is +used, breakpoints can be viewed and set using the Snapshot Debugger CLI instead +of the Cloud Console. + +To use the Firebase backend, set the following system properties: + +``` +-Dcom.google.cdbg.agent.use_firebase=True +``` + +Additional configuration can be provided if necessary: + +``` +-Dcom.google.cdbg.agent.use_firebase=True +-Dcom.google.cdbg.agent.firebase_db_url=https://my-database-url.firebaseio.com +``` + +See https://github.com/GoogleCloudPlatform/snapshot-debugger for more details. diff --git a/src/agent/internals/src/main/java/com/google/devtools/cdbg/debuglets/java/GcpDebugletVersion.java b/src/agent/internals/src/main/java/com/google/devtools/cdbg/debuglets/java/GcpDebugletVersion.java index f8d5dc1b..f0e9b004 100644 --- a/src/agent/internals/src/main/java/com/google/devtools/cdbg/debuglets/java/GcpDebugletVersion.java +++ b/src/agent/internals/src/main/java/com/google/devtools/cdbg/debuglets/java/GcpDebugletVersion.java @@ -21,10 +21,10 @@ public final class GcpDebugletVersion { *

All agents of the same major version are compatible with each other. In other words an * application can mix different agents with the same major version within the same debuggee. */ - public static final int MAJOR_VERSION = 2; + public static final int MAJOR_VERSION = 3; /** Minor version of the agent. */ - public static final int MINOR_VERSION = 32; + public static final int MINOR_VERSION = 0; /** Debugger agent version string in the format of MAJOR.MINOR. */ public static final String VERSION = String.format("%d.%d", MAJOR_VERSION, MINOR_VERSION);