From 726ab093955d2946458275fcc5bd41fb6cd3e35e Mon Sep 17 00:00:00 2001 From: Huiwen Date: Fri, 7 Jun 2024 16:38:41 +0000 Subject: [PATCH] [JetBrains] try it out Co-authored-by: Jean Pierre --- components/ide/jetbrains/launcher/main.go | 41 +++ .../ide/jetbrains/toolbox/.gitattributes | 8 + components/ide/jetbrains/toolbox/.gitignore | 6 + components/ide/jetbrains/toolbox/README.md | 17 ++ .../ide/jetbrains/toolbox/build.gradle.kts | 189 ++++++++++++++ .../ide/jetbrains/toolbox/gradle.properties | 4 + .../toolbox/gradle/libs.versions.toml | 29 +++ .../toolbox/gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 62076 bytes .../gradle/wrapper/gradle-wrapper.properties | 6 + components/ide/jetbrains/toolbox/gradlew | 245 ++++++++++++++++++ components/ide/jetbrains/toolbox/gradlew.bat | 92 +++++++ .../ide/jetbrains/toolbox/settings.gradle.kts | 9 + .../gitpod/toolbox/auth/GitpodAuthManager.kt | 189 ++++++++++++++ .../io/gitpod/toolbox/auth/GitpodLoginPage.kt | 43 +++ .../toolbox/auth/GitpodOrganizationPage.kt | 58 +++++ .../toolbox/colima/ColimaTestEnvironment.kt | 70 +++++ .../toolbox/components/AbstractUiPage.kt | 33 +++ .../io/gitpod/toolbox/components/Button.kt | 16 ++ .../toolbox/components/ComponentsPage.kt | 64 +++++ .../io/gitpod/toolbox/components/Icon.kt | 12 + .../toolbox/gateway/GitpodGatewayExtension.kt | 18 ++ .../io/gitpod/toolbox/gateway/GitpodLogger.kt | 18 ++ .../gateway/GitpodNewEnvironmentPage.kt | 110 ++++++++ .../toolbox/gateway/GitpodRemoteProvider.kt | 197 ++++++++++++++ .../GitpodRemoteProviderEnvironment.kt | 132 ++++++++++ .../GitpodSSHEnvironmentContentsView.kt | 48 ++++ .../toolbox/gateway/GitpodUriHandler.kt | 60 +++++ .../kotlin/io/gitpod/toolbox/gateway/await.kt | 26 ++ .../io/gitpod/toolbox/service/DataManager.kt | 85 ++++++ .../service/GitpodConnectionProvider.kt | 96 +++++++ .../toolbox/service/GitpodPublicApiManager.kt | 187 +++++++++++++ .../service/GitpodWebSocketTunnelServer.kt | 218 ++++++++++++++++ .../io/gitpod/toolbox/service/PageRouter.kt | 75 ++++++ .../kotlin/io/gitpod/toolbox/service/Utils.kt | 63 +++++ ...jetbrains.toolbox.gateway.GatewayExtension | 1 + .../src/main/resources/dependencies.json | 44 ++++ .../toolbox/src/main/resources/extension.json | 20 ++ .../toolbox/src/main/resources/icon.svg | 1 + components/server/src/oauth-server/db.ts | 12 + 39 files changed, 2542 insertions(+) create mode 100644 components/ide/jetbrains/toolbox/.gitattributes create mode 100644 components/ide/jetbrains/toolbox/.gitignore create mode 100644 components/ide/jetbrains/toolbox/README.md create mode 100644 components/ide/jetbrains/toolbox/build.gradle.kts create mode 100644 components/ide/jetbrains/toolbox/gradle.properties create mode 100644 components/ide/jetbrains/toolbox/gradle/libs.versions.toml create mode 100644 components/ide/jetbrains/toolbox/gradle/wrapper/gradle-wrapper.jar create mode 100644 components/ide/jetbrains/toolbox/gradle/wrapper/gradle-wrapper.properties create mode 100755 components/ide/jetbrains/toolbox/gradlew create mode 100644 components/ide/jetbrains/toolbox/gradlew.bat create mode 100644 components/ide/jetbrains/toolbox/settings.gradle.kts create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodAuthManager.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodLoginPage.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodOrganizationPage.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/colima/ColimaTestEnvironment.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/AbstractUiPage.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/Button.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/ComponentsPage.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/Icon.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodGatewayExtension.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodLogger.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodNewEnvironmentPage.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodRemoteProvider.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodRemoteProviderEnvironment.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodSSHEnvironmentContentsView.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodUriHandler.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/await.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/DataManager.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodConnectionProvider.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodPublicApiManager.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodWebSocketTunnelServer.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/PageRouter.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/Utils.kt create mode 100644 components/ide/jetbrains/toolbox/src/main/resources/META-INF/services/com.jetbrains.toolbox.gateway.GatewayExtension create mode 100644 components/ide/jetbrains/toolbox/src/main/resources/dependencies.json create mode 100644 components/ide/jetbrains/toolbox/src/main/resources/extension.json create mode 100644 components/ide/jetbrains/toolbox/src/main/resources/icon.svg diff --git a/components/ide/jetbrains/launcher/main.go b/components/ide/jetbrains/launcher/main.go index 79007f615c7075..6386d7de0daf04 100644 --- a/components/ide/jetbrains/launcher/main.go +++ b/components/ide/jetbrains/launcher/main.go @@ -178,6 +178,13 @@ func main() { launch(launchCtx) return } + + err = configureToolboxCliProperties(backendDir) + if err != nil { + log.WithError(err).Error("failed to write toolbox cli config file") + return + } + // we should start serving immediately and postpone launch // in order to enable a JB Gateway to connect as soon as possible go launch(launchCtx) @@ -1183,3 +1190,37 @@ func resolveProjectContextDir(launchCtx *LaunchContext) string { return launchCtx.projectDir } + +func configureToolboxCliProperties(backendDir string) error { + userHomeDir, err := os.UserHomeDir() + if err != nil { + return err + } + + toolboxCliPropertiesDir := fmt.Sprintf("%s/.local/share/JetBrains/Toolbox", userHomeDir) + _, err = os.Stat(toolboxCliPropertiesDir) + if !os.IsNotExist(err) { + return err + } + err = os.MkdirAll(toolboxCliPropertiesDir, os.ModePerm) + if err != nil { + return err + } + + toolboxCliPropertiesFilePath := fmt.Sprintf("%s/environment.json", toolboxCliPropertiesDir) + + content := fmt.Sprintf(`{ + "tools": { + "allowInstallation": false, + "allowUpdate": false, + "allowUninstallation": false, + "location": [ + { + "path": "%s" + } + ] + } +}`, backendDir) + + return os.WriteFile(toolboxCliPropertiesFilePath, []byte(content), 0o644) +} diff --git a/components/ide/jetbrains/toolbox/.gitattributes b/components/ide/jetbrains/toolbox/.gitattributes new file mode 100644 index 00000000000000..afd59d8fce15d0 --- /dev/null +++ b/components/ide/jetbrains/toolbox/.gitattributes @@ -0,0 +1,8 @@ +# +# https://help.github.com/articles/dealing-with-line-endings/ +# +# Linux start script should use lf +/gradlew text eol=lf + +# These are Windows script files and should use crlf +*.bat text eol=crlf diff --git a/components/ide/jetbrains/toolbox/.gitignore b/components/ide/jetbrains/toolbox/.gitignore new file mode 100644 index 00000000000000..83d0ea8e397220 --- /dev/null +++ b/components/ide/jetbrains/toolbox/.gitignore @@ -0,0 +1,6 @@ +# Gradle +.gradle +build + +# IntelliJ IDEA +.idea diff --git a/components/ide/jetbrains/toolbox/README.md b/components/ide/jetbrains/toolbox/README.md new file mode 100644 index 00000000000000..869005a898825d --- /dev/null +++ b/components/ide/jetbrains/toolbox/README.md @@ -0,0 +1,17 @@ +# Gitpod Toolbox Plugin + +To load plugin into the provided Toolbox App, run `./gradlew build copyPlugin` + +or put files in the following directory: + +* Windows: `%LocalAppData%/JetBrains/Toolbox/cache/plugins/plugin-id` +* macOS: `~/Library/Caches/JetBrains/Toolbox/plugins/plugin-id` +* Linux: `~/.local/share/JetBrains/Toolbox/plugins/plugin-id` + + +## How to Develop + +- Open the Toolbox App in debug mode +```bash +TOOLBOX_DEV_DEBUG_SUSPEND=true && open /Applications/JetBrains\ Toolbox.app +``` diff --git a/components/ide/jetbrains/toolbox/build.gradle.kts b/components/ide/jetbrains/toolbox/build.gradle.kts new file mode 100644 index 00000000000000..ff6b421b5ec1e3 --- /dev/null +++ b/components/ide/jetbrains/toolbox/build.gradle.kts @@ -0,0 +1,189 @@ +import com.github.jk1.license.filter.ExcludeTransitiveDependenciesFilter +import com.github.jk1.license.render.JsonReportRenderer +import org.jetbrains.intellij.pluginRepository.PluginRepositoryFactory +import org.jetbrains.kotlin.com.intellij.openapi.util.SystemInfoRt +import java.nio.file.Path +import kotlin.io.path.div + +plugins { + alias(libs.plugins.kotlin) + alias(libs.plugins.serialization) + `java-library` + alias(libs.plugins.dependency.license.report) + id("com.github.johnrengelman.shadow") version "8.1.1" +} + +buildscript { + dependencies { + classpath(libs.marketplace.client) + } +} + +repositories { + mavenCentral() + maven("https://packages.jetbrains.team/maven/p/tbx/gateway") +} + +dependencies { + implementation(project(":supervisor-api")) + implementation(project(":gitpod-publicapi")) + + // connect rpc dependencies + implementation("com.squareup.okhttp3:okhttp:4.12.0") + implementation("com.connectrpc:connect-kotlin-okhttp:0.6.0") + implementation("com.connectrpc:connect-kotlin:0.6.0") + // Java specific dependencies. + implementation("com.connectrpc:connect-kotlin-google-java-ext:0.6.0") + implementation("com.google.protobuf:protobuf-java:4.26.0") + // WebSocket + compileOnly("javax.websocket:javax.websocket-api:1.1") + compileOnly("org.eclipse.jetty.websocket:websocket-api:9.4.54.v20240208") + implementation("org.eclipse.jetty.websocket:javax-websocket-client-impl:9.4.54.v20240208") + // RD-Core + implementation("com.jetbrains.rd:rd-core:2024.1.1") + + implementation(libs.gateway.api) + implementation(libs.slf4j) + implementation(libs.bundles.serialization) + implementation(libs.coroutines.core) + implementation(libs.okhttp) +} + + +val pluginId = "io.gitpod.toolbox.gateway" +val pluginVersion = "0.0.1" + +tasks.shadowJar { + archiveBaseName.set(pluginId) + archiveVersion.set(pluginVersion) + + val excludedGroups = listOf( + "com.jetbrains.toolbox.gateway", + "com.jetbrains", + "org.jetbrains", + "com.squareup.okhttp3", + "org.slf4j", + "org.jetbrains.intellij", + "com.squareup.okio", + "kotlin." + ) + + val includeGroups = listOf( + "com.jetbrains.rd" + ) + + dependencies { + exclude { + excludedGroups.any { group -> + if (includeGroups.any { includeGroup -> it.name.startsWith(includeGroup) }) { + return@any false + } + it.name.startsWith(group) + } + } + } +} + +licenseReport { + renderers = arrayOf(JsonReportRenderer("dependencies.json")) + filters = arrayOf(ExcludeTransitiveDependenciesFilter()) + // jq script to convert to our format: + // `jq '[.dependencies[] | {name: .moduleName, version: .moduleVersion, url: .moduleUrl, license: .moduleLicense, licenseUrl: .moduleLicenseUrl}]' < build/reports/dependency-license/dependencies.json > src/main/resources/dependencies.json` +} + +tasks.compileKotlin { + kotlinOptions.freeCompilerArgs += listOf( + "-opt-in=kotlinx.serialization.ExperimentalSerializationApi", + ) +} + +val restartToolbox by tasks.creating { + group = "01.Gitpod" + description = "Restarts the JetBrains Toolbox app." + + doLast { + when { + SystemInfoRt.isMac -> { + exec { + commandLine("sh", "-c", "pkill -f 'JetBrains Toolbox' || true") + } + Thread.sleep(3000) + exec { + commandLine("sh", "-c", "echo debugClean > ~/Library/Logs/JetBrains/Toolbox/toolbox.log") + } + exec { + commandLine("open", "/Applications/JetBrains Toolbox.app") + } + } + else -> { + println("restart Toolbox to make plugin works.") + } + } + } +} + +val copyPlugin by tasks.creating(Sync::class.java) { + group = "01.Gitpod" + + dependsOn(tasks.named("shadowJar")) + from(tasks.named("shadowJar").get().outputs.files) + + val userHome = System.getProperty("user.home").let { Path.of(it) } + val toolboxCachesDir = when { + SystemInfoRt.isWindows -> System.getenv("LOCALAPPDATA")?.let { Path.of(it) } ?: (userHome / "AppData" / "Local") + // currently this is the location that TBA uses on Linux + SystemInfoRt.isLinux -> System.getenv("XDG_DATA_HOME")?.let { Path.of(it) } ?: (userHome / ".local" / "share") + SystemInfoRt.isMac -> userHome / "Library" / "Caches" + else -> error("Unknown os") + } / "JetBrains" / "Toolbox" + + val pluginsDir = when { + SystemInfoRt.isWindows -> toolboxCachesDir / "cache" + SystemInfoRt.isLinux || SystemInfoRt.isMac -> toolboxCachesDir + else -> error("Unknown os") + } / "plugins" + + val targetDir = pluginsDir / pluginId + + from("src/main/resources") { + include("extension.json") + include("dependencies.json") + include("icon.svg") + } + + into(targetDir) + + finalizedBy(restartToolbox) +} + +val pluginZip by tasks.creating(Zip::class) { + dependsOn(tasks.named("shadowJar")) + from(tasks.named("shadowJar").get().outputs.files) + + from("src/main/resources") { + include("extension.json") + include("dependencies.json") + } + from("src/main/resources") { + include("icon.svg") + rename("icon.svg", "pluginIcon.svg") + } + archiveBaseName.set("$pluginId-$pluginVersion") +} + +val uploadPlugin by tasks.creating { + dependsOn(pluginZip) + + doLast { + val instance = PluginRepositoryFactory.create( + "https://plugins.jetbrains.com", + project.property("pluginMarketplaceToken").toString() + ) + + // first upload + // instance.uploader.uploadNewPlugin(pluginZip.outputs.files.singleFile, listOf("toolbox", "gateway"), LicenseUrl.APACHE_2_0, ProductFamily.TOOLBOX) + + // subsequent updates + instance.uploader.upload(pluginId, pluginZip.outputs.files.singleFile) + } +} diff --git a/components/ide/jetbrains/toolbox/gradle.properties b/components/ide/jetbrains/toolbox/gradle.properties new file mode 100644 index 00000000000000..9d45e708410982 --- /dev/null +++ b/components/ide/jetbrains/toolbox/gradle.properties @@ -0,0 +1,4 @@ +pluginVersion=0.0.1 +environmentName=latest +supervisorApiProjectPath=../../../supervisor-api/java +gitpodPublicApiProjectPath=../../../public-api/java diff --git a/components/ide/jetbrains/toolbox/gradle/libs.versions.toml b/components/ide/jetbrains/toolbox/gradle/libs.versions.toml new file mode 100644 index 00000000000000..cdac41588bd02c --- /dev/null +++ b/components/ide/jetbrains/toolbox/gradle/libs.versions.toml @@ -0,0 +1,29 @@ +[versions] +gateway = "2.4.0.30948" +kotlin = "1.9.0" +coroutines = "1.7.3" +serialization = "1.5.0" +okhttp = "4.10.0" +slf4j = "2.0.3" +dependency-license-report = "2.5" +marketplace-client = "2.0.38" + +[libraries] +kotlin-stdlib = { module = "com.jetbrains.kotlin:kotlin-stdlib", version.ref = "kotlin" } +gateway-api = { module = "com.jetbrains.toolbox.gateway:gateway-api", version.ref = "gateway" } +coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines" } +serialization-core = { module = "org.jetbrains.kotlinx:kotlinx-serialization-core", version.ref = "serialization" } +serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "serialization" } +serialization-json-okio = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json-okio", version.ref = "serialization" } +okhttp = { module = "com.squareup.okhttp3:okhttp", version.ref = "okhttp" } +slf4j = { module = "org.slf4j:slf4j-api", version.ref = "slf4j" } + +marketplace-client = { module = "org.jetbrains.intellij:plugin-repository-rest-client", version.ref = "marketplace-client" } + +[bundles] +serialization = [ "serialization-core", "serialization-json", "serialization-json-okio" ] + +[plugins] +kotlin = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" } +serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" } +dependency-license-report = { id = "com.github.jk1.dependency-license-report", version.ref = "dependency-license-report" } diff --git a/components/ide/jetbrains/toolbox/gradle/wrapper/gradle-wrapper.jar b/components/ide/jetbrains/toolbox/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..c1962a79e29d3e0ab67b14947c167a862655af9b GIT binary patch literal 62076 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 literal 0 HcmV?d00001 diff --git a/components/ide/jetbrains/toolbox/gradle/wrapper/gradle-wrapper.properties b/components/ide/jetbrains/toolbox/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 00000000000000..0c85a1f7519700 --- /dev/null +++ b/components/ide/jetbrains/toolbox/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,6 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.1-bin.zip +networkTimeout=10000 +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/components/ide/jetbrains/toolbox/gradlew b/components/ide/jetbrains/toolbox/gradlew new file mode 100755 index 00000000000000..aeb74cbb43e393 --- /dev/null +++ b/components/ide/jetbrains/toolbox/gradlew @@ -0,0 +1,245 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +############################################################################## +# +# Gradle start up script for POSIX generated by Gradle. +# +# Important for running: +# +# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is +# noncompliant, but you have some other compliant shell such as ksh or +# bash, then to run this script, type that shell name before the whole +# command line, like: +# +# ksh Gradle +# +# Busybox and similar reduced shells will NOT work, because this script +# requires all of these POSIX shell features: +# * functions; +# * expansions «$var», «${var}», «${var:-default}», «${var+SET}», +# «${var#prefix}», «${var%suffix}», and «$( cmd )»; +# * compound commands having a testable exit status, especially «case»; +# * various built-in commands including «command», «set», and «ulimit». +# +# Important for patching: +# +# (2) This script targets any POSIX shell, so it avoids extensions provided +# by Bash, Ksh, etc; in particular arrays are avoided. +# +# The "traditional" practice of packing multiple parameters into a +# space-separated string is a well documented source of bugs and security +# problems, so this is (mostly) avoided, by progressively accumulating +# options in "$@", and eventually passing that to Java. +# +# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS, +# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly; +# see the in-line comments for details. +# +# There are tweaks for specific operating systems such as AIX, CygWin, +# Darwin, MinGW, and NonStop. +# +# (3) This script is generated from the Groovy template +# https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt +# within the Gradle project. +# +# You can find Gradle at https://github.com/gradle/gradle/. +# +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +# This is normally unused +# shellcheck disable=SC2034 +APP_BASE_NAME=${0##*/} +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC3045 + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC3045 + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/components/ide/jetbrains/toolbox/gradlew.bat b/components/ide/jetbrains/toolbox/gradlew.bat new file mode 100644 index 00000000000000..93e3f59f135dd2 --- /dev/null +++ b/components/ide/jetbrains/toolbox/gradlew.bat @@ -0,0 +1,92 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +@rem This is normally unused +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if %ERRORLEVEL% equ 0 goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/components/ide/jetbrains/toolbox/settings.gradle.kts b/components/ide/jetbrains/toolbox/settings.gradle.kts new file mode 100644 index 00000000000000..9732826b70f69c --- /dev/null +++ b/components/ide/jetbrains/toolbox/settings.gradle.kts @@ -0,0 +1,9 @@ +rootProject.name = "gitpod-toolbox-gateway" + +include(":supervisor-api") +val supervisorApiProjectPath: String by settings +project(":supervisor-api").projectDir = File(supervisorApiProjectPath) + +include(":gitpod-publicapi") +val gitpodPublicApiProjectPath: String by settings +project(":gitpod-publicapi").projectDir = File(gitpodPublicApiProjectPath) diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodAuthManager.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodAuthManager.kt new file mode 100644 index 00000000000000..d7148bd98a7f52 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodAuthManager.kt @@ -0,0 +1,189 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.auth + +import com.jetbrains.toolbox.gateway.auth.* +import io.gitpod.publicapi.v1.UserServiceClient +import io.gitpod.toolbox.service.GitpodPublicApiManager +import io.gitpod.toolbox.service.Utils +import kotlinx.coroutines.future.future +import kotlinx.serialization.Serializable +import kotlinx.serialization.decodeFromString +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json +import kotlinx.serialization.json.jsonObject +import kotlinx.serialization.json.jsonPrimitive +import org.slf4j.LoggerFactory +import java.net.URI +import java.util.* +import java.util.concurrent.Future + +class GitpodAuthManager { + private val logger = LoggerFactory.getLogger(javaClass) + private val manager: PluginAuthManager + private var loginListeners: MutableList<() -> Unit> = mutableListOf() + private var logoutListeners: MutableList<() -> Unit> = mutableListOf() + + init { + manager = Utils.sharedServiceLocator.getAuthManager( + "gitpod", + GitpodAccount::class.java, + { it.encode() }, + { GitpodAccount.decode(it) }, + { oauthToken, authCfg -> getAuthenticatedUser(authCfg.baseUrl, oauthToken) }, + { oauthToken, gpAccount -> getAuthenticatedUser(gpAccount.getHost(), oauthToken) }, + { gpLoginCfg -> + val authParams = mapOf( + "response_type" to "code", + "client_id" to "toolbox-gateway-gitpod-plugin", + "scope" to "function:*", + ) + val tokenParams = + mapOf("grant_type" to "authorization_code", "client_id" to "toolbox-gateway-gitpod-plugin") + AuthConfiguration( + authParams, + tokenParams, + gpLoginCfg.host, + gpLoginCfg.host + "/api/oauth/authorize", + gpLoginCfg.host + "/api/oauth/token", + "code_challenge", + "S256", + "code_verifier", + "Bearer" + ) + }, + { RefreshConfiguration("", mapOf(), "", ContentType.JSON) }, + ) + + manager.addEventListener { + when (it.type) { + AuthEvent.Type.LOGIN -> { + logger.info("account ${it.accountId} logged in") + loginListeners.forEach { it() } + } + AuthEvent.Type.LOGOUT -> { + logger.info("account ${it.accountId} logged out") + logoutListeners.forEach { it() } + } + } + } + } + + fun getCurrentAccount(): GitpodAccount? { + return manager.accountsWithStatus.firstOrNull()?.account + } + + fun logout() { + getCurrentAccount()?.let { manager.logout(it.id) } + } + + fun getOAuthLoginUrl(gitpodHost: String): String { + logger.info("get oauth url of $gitpodHost") + return manager.initiateLogin(GitpodLoginConfiguration(gitpodHost)) + } + + fun tryHandle(uri: URI): Boolean { + if (!this.manager.canHandle(uri)) { + return false + } + Utils.toolboxUi.showWindow() + this.manager.handle(uri) + return true + } + + fun addLoginListener(listener: () -> Unit) { + loginListeners.add(listener) + } + + fun addLogoutListener(listener: () -> Unit) { + logoutListeners.add(listener) + } + + private fun getAuthenticatedUser(gitpodHost: String, oAuthToken: OAuthToken): Future { + return Utils.coroutineScope.future { + val bearerToken = getBearerToken(oAuthToken) + val client = GitpodPublicApiManager.createClient(gitpodHost, bearerToken) + val user = GitpodPublicApiManager.tryGetAuthenticatedUser(UserServiceClient(client), logger) + GitpodAccount(bearerToken, user.id, user.name, gitpodHost) + } + } + + private fun getBearerToken(oAuthToken: OAuthToken): String { + val parts = oAuthToken.authorizationHeader.replace("Bearer ", "").split(".") + // We don't validate jwt token + if (parts.size != 3) { + throw IllegalArgumentException("Invalid JWT") + } + val decoded = String(Base64.getUrlDecoder().decode(parts[1].toByteArray())) + val jsonElement = Json.parseToJsonElement(decoded) + val payloadMap = jsonElement.jsonObject.mapValues { + it.value.jsonPrimitive.content + } + return payloadMap["jti"] ?: throw IllegalArgumentException("Failed to parse JWT token") + } + +} + +class GitpodLoginConfiguration(val host: String) + +@Serializable +class GitpodAccount( + private val credentials: String, + private val id: String, + private val name: String, + private val host: String +) : Account { + private val orgSelectedListeners: MutableList<(String) -> Unit> = mutableListOf() + private val logger = LoggerFactory.getLogger(javaClass) + + override fun getId() = id + override fun getFullName() = name + fun getCredentials() = credentials + fun getHost() = host + + private fun getStoreKey(key: String) = "USER:${id}:${key}" + + var organizationId: String? + get() = Utils.settingStore[getStoreKey("ORG")] + set(value){ + if (value == null) { + return + } + Utils.settingStore[getStoreKey("ORG")] = value + orgSelectedListeners.forEach { it(value) } + } + + var preferEditor: String? + get() = Utils.settingStore[getStoreKey("EDITOR")] + set(value){ + if (value == null) { + return + } + Utils.settingStore[getStoreKey("EDITOR")] = value + } + + var preferWorkspaceClass: String? + get() = Utils.settingStore[getStoreKey("WS_CLS")] + set(value){ + if (value == null) { + return + } + Utils.settingStore[getStoreKey("WS_CLS")] = value + } + + fun onOrgSelected(listener: (String) -> Unit) { + orgSelectedListeners.add(listener) + } + + fun encode(): String { + return Json.encodeToString(this) + } + + companion object { + fun decode(str: String): GitpodAccount { + return Json.decodeFromString(str) + } + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodLoginPage.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodLoginPage.kt new file mode 100644 index 00000000000000..110caf92b5e6c1 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodLoginPage.kt @@ -0,0 +1,43 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.auth + +import com.jetbrains.toolbox.gateway.ui.* +import io.gitpod.toolbox.components.AbstractUiPage +import io.gitpod.toolbox.components.GitpodIcon +import io.gitpod.toolbox.components.SimpleButton +import io.gitpod.toolbox.service.Utils + +class GitpodLoginPage(private val authManager: GitpodAuthManager) : AbstractUiPage() { + private val hostField = TextField("Host", "https://exp-migration.preview.gitpod-dev.com", null) { + if (it.isBlank()) { + ValidationResult.Invalid("Host should not be empty") + } + if (!it.startsWith("https://")) { + ValidationResult.Invalid("Host should start with https://") + } + ValidationResult.Valid + } + + override fun getFields(): MutableList { + return mutableListOf(hostField, LinkField("Learn more", "https://gitpod.io/docs")) + } + + override fun getActionButtons(): MutableList { + return mutableListOf(SimpleButton("Login") action@{ + val host = getFieldValue(hostField) ?: return@action + val url = authManager.getOAuthLoginUrl(host) + Utils.openUrl(url) + }) + } + + override fun getTitle() = "Login to Gitpod" + + override fun getDescription() = "Always ready to code." + + override fun getSvgIcon(): ByteArray { + return GitpodIcon() + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodOrganizationPage.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodOrganizationPage.kt new file mode 100644 index 00000000000000..09f0cd8e6bc92e --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/auth/GitpodOrganizationPage.kt @@ -0,0 +1,58 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.auth + +import com.jetbrains.toolbox.gateway.ui.AutocompleteTextField +import com.jetbrains.toolbox.gateway.ui.AutocompleteTextField.AutocompleteItem +import com.jetbrains.toolbox.gateway.ui.AutocompleteTextField.MenuItem +import com.jetbrains.toolbox.gateway.ui.UiField +import com.jetbrains.toolbox.gateway.ui.ValidationResult +import io.gitpod.publicapi.v1.OrganizationOuterClass +import io.gitpod.toolbox.components.AbstractUiPage +import io.gitpod.toolbox.service.GitpodPublicApiManager +import io.gitpod.toolbox.service.Utils +import java.util.function.Consumer + +class GitpodOrganizationPage(val authManager: GitpodAuthManager, val publicApi: GitpodPublicApiManager) : + AbstractUiPage() { + private var organizations = emptyList() + private lateinit var orgField: AutocompleteTextField + + + suspend fun loadData() { + organizations = publicApi.listOrganizations() + } + + private fun getOrgField() = run { + val options = mutableListOf() + options.addAll(organizations.map { org -> + MenuItem(org.name, null, null) { + authManager.getCurrentAccount()?.organizationId = org.id + Utils.toolboxUi.hideUiPage(this) + } + }) + val orgName = organizations.find { it.id == authManager.getCurrentAccount()?.organizationId }?.name ?: "" + AutocompleteTextField("Organization", orgName, options, 1.0f) { + if (it.isNullOrEmpty()) { + ValidationResult.Invalid("Organization is required") + } + ValidationResult.Valid + } + } + + override fun getFields(): MutableList { + this.orgField = getOrgField() + return mutableListOf(this.orgField) + } + + override fun getTitle(): String { + return "Select organization" + } + + override fun setPageChangedListener(listener: Consumer) { + super.setPageChangedListener(listener) + listener.accept(null) + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/colima/ColimaTestEnvironment.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/colima/ColimaTestEnvironment.kt new file mode 100644 index 00000000000000..e081717757af31 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/colima/ColimaTestEnvironment.kt @@ -0,0 +1,70 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.colima + +import com.jetbrains.toolbox.gateway.AbstractRemoteProviderEnvironment +import com.jetbrains.toolbox.gateway.EnvironmentVisibilityState +import com.jetbrains.toolbox.gateway.environments.EnvironmentContentsView +import com.jetbrains.toolbox.gateway.environments.ManualEnvironmentContentsView +import com.jetbrains.toolbox.gateway.environments.SshEnvironmentContentsView +import com.jetbrains.toolbox.gateway.ssh.SshConnectionInfo +import com.jetbrains.toolbox.gateway.states.StandardRemoteEnvironmentState +import com.jetbrains.toolbox.gateway.ui.ActionDescription +import com.jetbrains.toolbox.gateway.ui.ActionListener +import com.jetbrains.toolbox.gateway.ui.ObservableList +import io.gitpod.toolbox.service.Utils +import kotlinx.coroutines.launch +import java.util.concurrent.CompletableFuture + +class ColimaTestEnvironment() : AbstractRemoteProviderEnvironment() { + private val actionListeners = mutableSetOf() + private val contentsViewFuture: CompletableFuture = + CompletableFuture.completedFuture(ColimaSSHEnvironmentContentsView()) + + init { + Utils.coroutineScope.launch { + Thread.sleep(2000) + listenerSet.forEach { it.consume(StandardRemoteEnvironmentState.Active) } + } + } + + override fun getId(): String = "colima" + override fun getName(): String = "colima" + + override fun getContentsView(): CompletableFuture = contentsViewFuture + + override fun setVisible(visibilityState: EnvironmentVisibilityState) { + + } + + override fun getActionList(): ObservableList { + return Utils.observablePropertiesFactory.emptyObservableList() + } + +} + +class ColimaSSHEnvironmentContentsView : SshEnvironmentContentsView, ManualEnvironmentContentsView { + private val listenerSet = mutableSetOf() + + override fun getConnectionInfo(): CompletableFuture { + return CompletableFuture.completedFuture(object : SshConnectionInfo { + override fun getHost(): String = "127.0.0.1" + override fun getPort() = 51710 + override fun getUserName() = "hwen" + override fun getPrivateKeyPaths(): MutableList? { + return mutableListOf("/Users/hwen/.colima/_lima/_config/user") + } + }) + } + + override fun addEnvironmentContentsListener(listener: ManualEnvironmentContentsView.Listener) { + listenerSet += listener + } + + override fun removeEnvironmentContentsListener(listener: ManualEnvironmentContentsView.Listener) { + listenerSet -= listener + } + +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/AbstractUiPage.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/AbstractUiPage.kt new file mode 100644 index 00000000000000..56f0d4c534d885 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/AbstractUiPage.kt @@ -0,0 +1,33 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.components + +import com.jetbrains.toolbox.gateway.ui.UiField +import com.jetbrains.toolbox.gateway.ui.UiPage +import java.util.function.BiConsumer +import java.util.function.Consumer +import java.util.function.Function + +abstract class AbstractUiPage : UiPage { + private var stateSetter: BiConsumer? = null + private var stateGetter: Function? = null + private var errorSetter: Consumer? = null + + @Suppress("UNCHECKED_CAST") + fun getFieldValue(field: UiField) = stateGetter?.apply(field) as T? + fun setFieldValue(field: UiField, value: Any) = stateSetter?.accept(field, value) + fun setActionErrorMessage(error: String) = errorSetter?.accept(Throwable(error)) + + override fun setStateAccessor(setter: BiConsumer?, getter: Function?) { + super.setStateAccessor(setter, getter) + stateGetter = getter + stateSetter = setter + } + + override fun setActionErrorNotifier(notifier: Consumer?) { + super.setActionErrorNotifier(notifier) + errorSetter = notifier + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/Button.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/Button.kt new file mode 100644 index 00000000000000..2814128842a584 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/Button.kt @@ -0,0 +1,16 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.components + +import com.jetbrains.toolbox.gateway.ui.RunnableActionDescription + +open class SimpleButton(private val title: String, private val action: () -> Unit = {}): RunnableActionDescription { + override fun getLabel(): String { + return title + } + override fun run() { + action() + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/ComponentsPage.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/ComponentsPage.kt new file mode 100644 index 00000000000000..28d3851c9b7935 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/ComponentsPage.kt @@ -0,0 +1,64 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.components + +import com.jetbrains.toolbox.gateway.ui.* +import com.jetbrains.toolbox.gateway.ui.AutocompleteTextField.AutocompleteItem +import com.jetbrains.toolbox.gateway.ui.AutocompleteTextField.MenuItem +import org.slf4j.LoggerFactory + +class ComponentsPage() : AbstractUiPage() { + private val logger = LoggerFactory.getLogger(javaClass) + override fun getFields(): MutableList { + val item: AutocompleteItem = MenuItem("item1", "group1", "group desc") { + logger.info("selected item1") + } + val item2: AutocompleteItem = MenuItem("item2", "group1", "group desc") { + logger.info("selected item1") + } + val item3: AutocompleteItem = MenuItem("item3", "group2", "group desc") { + logger.info("selected item3") + } + return mutableListOf( + AutocompleteTextField("AutocompleteTextField", "", mutableListOf(item, item2, item3), null, null), + CheckboxField(false, "Checkbox"), + ComboBoxField( + "ComboBoxField", + "s1", + mutableListOf(ComboBoxField.LabelledValue("s1", "s1"), ComboBoxField.LabelledValue("s2", "s2")) + ), + LabelField("LabelField"), + RadioButtonField(false, "RadioButtonField2", "group_1"), + RowGroup( + RowGroup.RowField(RadioButtonField(true, "RadioButtonField-2", "group_1"), RowGroup.RowFieldSettings(1.0f)), + RowGroup.RowField(RadioButtonField(true, "RadioButtonField-1", "group_1"), RowGroup.RowFieldSettings(1.0f)), + ), + RowGroup( + RowGroup.RowField(LabelField("LabelField-1"), RowGroup.RowFieldSettings(1.0f)), + RowGroup.RowField(LabelField("LabelField-2"), RowGroup.RowFieldSettings(1.0f)), + ), + TextField("TextField", "", TextType.Password), + LinkField("LinkField", "https://gitpod.io/docs"), + ) + } + + override fun getActionButtons(): MutableList { + return mutableListOf(SimpleButton("Button") { + logger.info("button clicked") + }, object : RunnableActionDescription { + override fun getLabel() = "Dangerous Button" + + override fun run() { + logger.info("danger") + } + + override fun isDangerous() = true + }) + } + + override fun getTitle(): String { + return "View components" + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/Icon.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/Icon.kt new file mode 100644 index 00000000000000..2e0cacef0e5c98 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/components/Icon.kt @@ -0,0 +1,12 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.components + +import io.gitpod.toolbox.gateway.GitpodGatewayExtension + +@Suppress("FunctionName") +fun GitpodIcon(): ByteArray { + return GitpodGatewayExtension::class.java.getResourceAsStream("/icon.svg")?.readAllBytes() ?: byteArrayOf() +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodGatewayExtension.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodGatewayExtension.kt new file mode 100644 index 00000000000000..1d9565e981784d --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodGatewayExtension.kt @@ -0,0 +1,18 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.gateway + +import com.jetbrains.toolbox.gateway.GatewayExtension +import com.jetbrains.toolbox.gateway.RemoteEnvironmentConsumer +import com.jetbrains.toolbox.gateway.RemoteProvider +import com.jetbrains.toolbox.gateway.ToolboxServiceLocator +import io.gitpod.toolbox.service.Utils + +class GitpodGatewayExtension : GatewayExtension { + override fun createRemoteProviderPluginInstance(serviceLocator: ToolboxServiceLocator): RemoteProvider { + Utils.initialize(serviceLocator) + return GitpodRemoteProvider(serviceLocator.getService(RemoteEnvironmentConsumer::class.java)) + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodLogger.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodLogger.kt new file mode 100644 index 00000000000000..f9688e928bc094 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodLogger.kt @@ -0,0 +1,18 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.gateway + +import com.jetbrains.toolbox.gateway.deploy.DiagnosticInfoCollector +import java.nio.file.Path +import java.util.concurrent.CompletableFuture +import org.slf4j.Logger + + +class GitpodLogger(private val logger:Logger) : DiagnosticInfoCollector { + override fun collectAdditionalDiagnostics(p0: Path): CompletableFuture<*> { + logger.info(">>>>>> $p0") + TODO("Not yet implemented") + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodNewEnvironmentPage.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodNewEnvironmentPage.kt new file mode 100644 index 00000000000000..4032bec4d9eaf9 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodNewEnvironmentPage.kt @@ -0,0 +1,110 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.gateway + +import com.jetbrains.toolbox.gateway.ui.ActionDescription +import com.jetbrains.toolbox.gateway.ui.ComboBoxField +import com.jetbrains.toolbox.gateway.ui.TextField +import com.jetbrains.toolbox.gateway.ui.TextType +import com.jetbrains.toolbox.gateway.ui.UiField +import io.gitpod.toolbox.auth.GitpodAuthManager +import io.gitpod.toolbox.components.AbstractUiPage +import io.gitpod.toolbox.components.SimpleButton +import io.gitpod.toolbox.service.GitpodPublicApiManager +import io.gitpod.toolbox.service.Utils +import kotlinx.coroutines.launch +import org.slf4j.LoggerFactory + +class GitpodNewEnvironmentPage(val authManager: GitpodAuthManager, val publicApi: GitpodPublicApiManager) : + AbstractUiPage() { + private val logger = LoggerFactory.getLogger(javaClass) + + override fun getFields(): MutableList { + return mutableListOf(orgField, contextUrlField, editorField, workspaceClassField) + } + + override fun getTitle(): String { + return "New environment" + } + + override fun getActionButtons(): MutableList { + return mutableListOf(SimpleButton("Create") { + val contextUrl = getFieldValue(contextUrlField) ?: return@SimpleButton + val editor = getFieldValue(editorField) ?: return@SimpleButton + val workspaceClass = getFieldValue(workspaceClassField) ?: return@SimpleButton + if (contextUrl.isBlank()) { + setActionErrorMessage("Context URL is required") + return@SimpleButton + } + if (editor.isBlank()) { + setActionErrorMessage("Editor is required") + return@SimpleButton + } + if (workspaceClass.isBlank()) { + setActionErrorMessage("Workspace class is required") + return@SimpleButton + } + Utils.coroutineScope.launch { + val workspace = publicApi.createAndStartWorkspace(contextUrl, editor, workspaceClass, null) + logger.info("workspace: ${workspace.id} created") + } + }) + } + + private val orgField = getOrgField() + private fun getOrgField(): TextField { + // TODO: Use ComboBoxField or AutocompleteTextField with org results + return TextField("Organization", authManager.getCurrentAccount()?.organizationId ?: "", TextType.General) + } + + // TODO: Use AutocompleteTextField with suggestions from API + // TODO: Add account recent repositories related field? Or get from auto start options + private val contextUrlField = + TextField("Context URL", "https://github.com/Gitpod-Samples/spring-petclinic", TextType.General) + + // TODO: get from API + private val editorField = ComboBoxField( + "Editor", + authManager.getCurrentAccount()?.preferEditor ?: "intellij", + listOf( + ComboBoxField.LabelledValue("IntelliJ IDEA", "intellij"), + ComboBoxField.LabelledValue("Goland", "goland") + ) + ) + + // TODO: get from API + private val workspaceClassField = ComboBoxField( + "Workspace Class", + authManager.getCurrentAccount()?.preferWorkspaceClass ?: "g1-standard", + listOf(ComboBoxField.LabelledValue("Standard", "g1-standard"), ComboBoxField.LabelledValue("Small", "g1-small")) + ) + + override fun fieldChanged(field: UiField) { + super.fieldChanged(field) + val account = authManager.getCurrentAccount() ?: return + if (field == orgField) { + val orgId = getFieldValue(orgField) ?: return + logger.info("set prefer orgId: $orgId") + account.organizationId = orgId + // Not works +// setFieldValue(orgField, orgId) + return + } + if (field == editorField) { + val editor = getFieldValue(editorField) ?: return + logger.info("set prefer editor: $editor") + account.preferEditor = editor + return + } + if (field == workspaceClassField) { + val cls = getFieldValue(workspaceClassField) ?: return + logger.info("set prefer workspaceClass: $cls") + account.preferWorkspaceClass = cls + // Not works +// setFieldValue(workspaceClassField, cls) + return + } + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodRemoteProvider.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodRemoteProvider.kt new file mode 100644 index 00000000000000..23ef461c3e6056 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodRemoteProvider.kt @@ -0,0 +1,197 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.gateway + +import com.jetbrains.toolbox.gateway.ProviderVisibilityState +import com.jetbrains.toolbox.gateway.RemoteEnvironmentConsumer +import com.jetbrains.toolbox.gateway.RemoteProvider +import com.jetbrains.toolbox.gateway.deploy.DiagnosticInfoCollector +import com.jetbrains.toolbox.gateway.ui.AccountDropdownField +import com.jetbrains.toolbox.gateway.ui.ActionDescription +import com.jetbrains.toolbox.gateway.ui.UiPage +import io.gitpod.toolbox.auth.GitpodAuthManager +import io.gitpod.toolbox.auth.GitpodLoginPage +import io.gitpod.toolbox.auth.GitpodOrganizationPage +import io.gitpod.toolbox.colima.ColimaTestEnvironment +import io.gitpod.toolbox.components.GitpodIcon +import io.gitpod.toolbox.components.SimpleButton +import io.gitpod.toolbox.service.GitpodPublicApiManager +import io.gitpod.toolbox.service.Utils +import kotlinx.coroutines.launch +import org.slf4j.LoggerFactory +import java.net.URI +import java.net.URLEncoder + +class GitpodRemoteProvider( + private val consumer: RemoteEnvironmentConsumer, +) : RemoteProvider { + private val logger = LoggerFactory.getLogger(javaClass) + private val authManger = GitpodAuthManager() + private val publicApi = GitpodPublicApiManager(authManger) + private val loginPage = GitpodLoginPage(authManger) + private val newEnvPage = GitpodNewEnvironmentPage(authManger, publicApi) + private val organizationPage = GitpodOrganizationPage(authManger, publicApi) + + // cache consumed environments map locally + private val environmentMap = mutableMapOf() + + private val openInToolboxUriHandler = GitpodOpenInToolboxUriHandler { connectParams -> + Utils.toolboxUi.showPluginEnvironmentsPage() + setEnvironmentVisibility(connectParams.workspaceId) + } + + // TODO: multiple host support + private fun setEnvironmentVisibility(workspaceId: String) { + logger.info("setEnvironmentVisibility $workspaceId") + Utils.toolboxUi.showWindow() + val env = environmentMap[workspaceId] + if (env != null) { + env.markActive() + Utils.clientHelper.setAutoConnectOnEnvironmentReady(workspaceId, "GO-233.15026.17", "/workspace/empty") + } else { + GitpodRemoteProviderEnvironment(authManger, workspaceId, publicApi).apply { + environmentMap[workspaceId] = this + this.markActive() + consumer.consumeEnvironments(listOf(this)) + Utils.clientHelper.setAutoConnectOnEnvironmentReady(workspaceId, "GO-233.15026.17", "/workspace/empty") + } + } + } + + init { + startup() + authManger.addLoginListener { + logger.info("user logged in ${authManger.getCurrentAccount()?.id}") + startup() + // TODO: showPluginEnvironmentsPage not refresh the page + Utils.toolboxUi.showPluginEnvironmentsPage() + } + authManger.addLogoutListener { + logger.info("user logged out ${authManger.getCurrentAccount()?.id}") + // TODO: showPluginEnvironmentsPage not refresh the page + Utils.toolboxUi.showPluginEnvironmentsPage() + } + Utils.coroutineScope.launch { + Utils.dataManager.sharedWorkspaceList.collect { workspaces -> + if (workspaces.isEmpty()) { + return@collect + } + workspaces.forEach{ + val host = URLEncoder.encode("https://exp-migration.preview.gitpod-dev.com", "UTF-8") + val workspaceId = URLEncoder.encode(it.id, "UTF-8") + val debugWorkspace = "false" + val newUri = "jetbrains://gateway/io.gitpod.toolbox.gateway/open-in-toolbox?host=${host}&workspaceId=${workspaceId}&debugWorkspace=${debugWorkspace}" + logger.info("workspace ${it.id} $newUri") + } + consumer.consumeEnvironments(workspaces.map { + val env = environmentMap[it.id] + if (env != null) { + env + } else { + val newEnv = GitpodRemoteProviderEnvironment(authManger, it.id, publicApi) + environmentMap[it.id] = newEnv + newEnv + } + }) + } + } + } + + private fun startup() { + val account = authManger.getCurrentAccount() ?: return + publicApi.setup() + val orgId = account.organizationId + logger.info("user logged in, current selected org: $orgId") + if (orgId != null) { + Utils.dataManager.startWatchWorkspaces(publicApi) + } else { + Utils.coroutineScope.launch { + organizationPage.loadData() + Utils.toolboxUi.showUiPage(organizationPage) + } + } + authManger.getCurrentAccount()?.onOrgSelected { + Utils.dataManager.startWatchWorkspaces(publicApi) + } + } + + override fun getOverrideUiPage(): UiPage? { + logger.info("getOverrideUiPage") + authManger.getCurrentAccount() ?: return loginPage + return null + } + + override fun close() {} + + override fun getName(): String = "Gitpod" + override fun getSvgIcon() = GitpodIcon() + + override fun getNewEnvironmentUiPage() = newEnvPage + + override fun getAccountDropDown(): AccountDropdownField? { + val account = authManger.getCurrentAccount() ?: return null + return AccountDropdownField(account.fullName) { + authManger.logout() + } + } + + private fun testColima() = run { + val env = ColimaTestEnvironment() + consumer.consumeEnvironments(listOf(env)) + Utils.clientHelper.setAutoConnectOnEnvironmentReady("colima", "IU-241.14494.240", "/home/hwen.linux/project") + } + + override fun getAdditionalPluginActions(): MutableList { + return mutableListOf( + SimpleButton("View documents") { + Utils.openUrl("https://gitpod.io/docs") + }, + SimpleButton("Colima") { + testColima() + }, + SimpleButton("Show toast") { + logger.info("toast shown") + val t = Utils.toolboxUi.showInfoPopup("This is header", "This is content", "okText") + Utils.coroutineScope.launch { + t.get() + logger.info("toast closed") + } + }, + SimpleButton("Select organization") { + Utils.coroutineScope.launch { + organizationPage.loadData() + Utils.toolboxUi.showUiPage(organizationPage) + } + } + ) + } + + override fun canCreateNewEnvironments(): Boolean = false + override fun isSingleEnvironment(): Boolean = false + + override fun setVisible(visibilityState: ProviderVisibilityState) {} + + override fun addEnvironmentsListener(listener: RemoteEnvironmentConsumer) {} + override fun removeEnvironmentsListener(listener: RemoteEnvironmentConsumer) {} + + override fun handleUri(uri: URI) { + if (authManger.tryHandle(uri)) { + return + } + if (openInToolboxUriHandler.tryHandle(uri)) { + return + } + when (uri.path) { + // TODO: + else -> { + logger.warn("Unknown request: {}", uri) + } + } + } + + override fun getDiagnosticInfoCollector(): DiagnosticInfoCollector? { + return GitpodLogger(logger) + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodRemoteProviderEnvironment.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodRemoteProviderEnvironment.kt new file mode 100644 index 00000000000000..4b1be52c5cb404 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodRemoteProviderEnvironment.kt @@ -0,0 +1,132 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.gateway + +import com.jetbrains.toolbox.gateway.AbstractRemoteProviderEnvironment +import com.jetbrains.toolbox.gateway.EnvironmentVisibilityState +import com.jetbrains.toolbox.gateway.environments.EnvironmentContentsView +import com.jetbrains.toolbox.gateway.states.StandardRemoteEnvironmentState +import com.jetbrains.toolbox.gateway.ui.ActionDescription +import com.jetbrains.toolbox.gateway.ui.ObservableList +import io.gitpod.publicapi.v1.WorkspaceOuterClass +import io.gitpod.publicapi.v1.WorkspaceOuterClass.WorkspacePhase +import io.gitpod.toolbox.auth.GitpodAuthManager +import io.gitpod.toolbox.components.SimpleButton +import io.gitpod.toolbox.service.GitpodPublicApiManager +import io.gitpod.toolbox.service.Utils +import kotlinx.coroutines.channels.BufferOverflow +import kotlinx.coroutines.flow.MutableSharedFlow +import kotlinx.coroutines.launch +import org.slf4j.LoggerFactory +import java.util.concurrent.CompletableFuture + +class GitpodRemoteProviderEnvironment( + private val authManager: GitpodAuthManager, + private val workspaceId: String, + private val publicApi: GitpodPublicApiManager, +) : AbstractRemoteProviderEnvironment() { + private val logger = LoggerFactory.getLogger(javaClass) + private val actionList = Utils.observablePropertiesFactory.emptyObservableList(); + private val contentsViewFuture: CompletableFuture = CompletableFuture.completedFuture( + GitpodSSHEnvironmentContentsView( + authManager, + workspaceId, + publicApi, + ) + ) + + private val lastWSEnvState = MutableSharedFlow(1, 0, BufferOverflow.DROP_OLDEST) + private var lastPhase: WorkspacePhase = + WorkspacePhase.newBuilder().setNameValue(WorkspacePhase.Phase.PHASE_UNSPECIFIED_VALUE).build() + private var isMarkActive = false + set(value) { + if (field != value) { + field = value + lastWSEnvState.tryEmit(WorkspaceEnvState(lastPhase, value)) + } + } + + fun markActive() { + isMarkActive = true + } + + init { + logger.info("==================GitpodRemoteProviderEnvironment.init $workspaceId") + Utils.coroutineScope.launch { + Utils.dataManager.watchWorkspaceStatus(workspaceId) { + lastPhase = it.phase + lastWSEnvState.tryEmit(WorkspaceEnvState(it.phase, isMarkActive)) + } + } + + Utils.coroutineScope.launch { + lastWSEnvState.collect { lastState -> + val state = lastState.getState() + val actions = mutableListOf() + if (lastState.isConnectable) { + actions += SimpleButton("Connect") { + isMarkActive = true + } + } + if (lastState.isCloseable) { + actions += SimpleButton("Close") { + isMarkActive = false + Utils.coroutineScope.launch { contentsViewFuture.get().close() } + } + } + if (lastState.isStoppable) { + actions += SimpleButton("Stop workspace") { + logger.info("===============stop workspace clicked") + } + } + actionList.clear() + actionList.addAll(actions) + listenerSet.forEach { it.consume(state) } + } + } + } + + override fun getId(): String = workspaceId + override fun getName(): String = workspaceId + + override fun getContentsView(): CompletableFuture = contentsViewFuture + + override fun setVisible(visibilityState: EnvironmentVisibilityState) { + + } + + override fun getActionList(): ObservableList = actionList +} + + +private class WorkspaceEnvState(val phase: WorkspacePhase, val isMarkActive: Boolean) { + val isConnectable = phase.nameValue == WorkspaceOuterClass.WorkspacePhase.Phase.PHASE_RUNNING_VALUE && !isMarkActive + val isCloseable = isMarkActive + val isStoppable = phase.nameValue == WorkspaceOuterClass.WorkspacePhase.Phase.PHASE_RUNNING_VALUE + + fun getState() = run { + if (isMarkActive && phase.nameValue == WorkspaceOuterClass.WorkspacePhase.Phase.PHASE_RUNNING_VALUE) { + StandardRemoteEnvironmentState.Active + } else { + phaseToStateMap[phase.nameValue] ?: StandardRemoteEnvironmentState.Unreachable + } + } + + companion object { + val phaseToStateMap = mapOf( + WorkspacePhase.Phase.PHASE_UNSPECIFIED_VALUE to StandardRemoteEnvironmentState.Unreachable, + WorkspacePhase.Phase.PHASE_PREPARING_VALUE to StandardRemoteEnvironmentState.Unreachable, + WorkspacePhase.Phase.PHASE_IMAGEBUILD_VALUE to StandardRemoteEnvironmentState.Unreachable, + WorkspacePhase.Phase.PHASE_PENDING_VALUE to StandardRemoteEnvironmentState.Unreachable, + WorkspacePhase.Phase.PHASE_CREATING_VALUE to StandardRemoteEnvironmentState.Unreachable, + WorkspacePhase.Phase.PHASE_INITIALIZING_VALUE to StandardRemoteEnvironmentState.Unreachable, + WorkspacePhase.Phase.PHASE_RUNNING_VALUE to StandardRemoteEnvironmentState.Inactive, + WorkspacePhase.Phase.PHASE_INTERRUPTED_VALUE to StandardRemoteEnvironmentState.Error, + WorkspacePhase.Phase.PHASE_PAUSED_VALUE to StandardRemoteEnvironmentState.Inactive, + WorkspacePhase.Phase.PHASE_STOPPING_VALUE to StandardRemoteEnvironmentState.Inactive, + WorkspacePhase.Phase.PHASE_STOPPED_VALUE to StandardRemoteEnvironmentState.Inactive + ) + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodSSHEnvironmentContentsView.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodSSHEnvironmentContentsView.kt new file mode 100644 index 00000000000000..daa087ce41a485 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodSSHEnvironmentContentsView.kt @@ -0,0 +1,48 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.gateway + +import com.jetbrains.toolbox.gateway.environments.ManualEnvironmentContentsView +import com.jetbrains.toolbox.gateway.environments.SshEnvironmentContentsView +import com.jetbrains.toolbox.gateway.ssh.SshConnectionInfo +import io.gitpod.toolbox.auth.GitpodAuthManager +import io.gitpod.toolbox.service.GitpodConnectionProvider +import io.gitpod.toolbox.service.GitpodPublicApiManager +import io.gitpod.toolbox.service.Utils +import kotlinx.coroutines.future.future +import org.slf4j.LoggerFactory +import java.util.concurrent.CompletableFuture + +class GitpodSSHEnvironmentContentsView( + private val authManager: GitpodAuthManager, + private val workspaceId: String, + private val publicApi: GitpodPublicApiManager, +) : SshEnvironmentContentsView, ManualEnvironmentContentsView { + private var cancel = {} + private val stateListeners = mutableSetOf() + + private val logger = LoggerFactory.getLogger(javaClass) + + override fun getConnectionInfo(): CompletableFuture { + return Utils.coroutineScope.future { + val provider = GitpodConnectionProvider(authManager, workspaceId, publicApi) + val (connInfo, cancel) = provider.connect() + this@GitpodSSHEnvironmentContentsView.cancel = cancel + return@future connInfo + } + } + + override fun addEnvironmentContentsListener(p0: ManualEnvironmentContentsView.Listener) { + stateListeners += p0 + } + + override fun removeEnvironmentContentsListener(p0: ManualEnvironmentContentsView.Listener) { + stateListeners -= p0 + } + + override fun close() { + cancel() + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodUriHandler.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodUriHandler.kt new file mode 100644 index 00000000000000..74b7dd4e2f0c0b --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/GitpodUriHandler.kt @@ -0,0 +1,60 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.gateway + +import io.gitpod.toolbox.service.ConnectParams +import org.slf4j.LoggerFactory +import java.net.URI +import java.util.concurrent.CompletableFuture +import java.util.concurrent.Future + +interface UriHandler { + fun parseUri(uri: URI): T + fun handle(data: T): Future + fun tryHandle(uri: URI): Boolean +} + +abstract class AbstractUriHandler : UriHandler { + private val logger = LoggerFactory.getLogger(javaClass) + abstract override fun parseUri(uri: URI): T + abstract override fun handle(data: T): Future + + override fun tryHandle(uri: URI) = try { + val data = parseUri(uri) + handle(data) + true + } catch (e: Exception) { + logger.warn("cannot parse URI", e) + false + } +} + +class GitpodOpenInToolboxUriHandler(val handler: (ConnectParams) -> Unit) : AbstractUriHandler() { + override fun handle(data: ConnectParams): Future = CompletableFuture.runAsync { handler(data) } + + override fun parseUri(uri: URI): ConnectParams { + val path = uri.path.split("/").last() + if (path != "open-in-toolbox") { + throw IllegalArgumentException("invalid URI: $path") + } + val query = uri.query ?: throw IllegalArgumentException("invalid URI: ${uri.query}") + val params = query.split("&").map { it.split("=") }.associate { it[0] to it[1] } + val host = params["host"] + val workspaceId = params["workspaceId"] + val debugWorkspace = params["debugWorkspace"]?.toBoolean() ?: false + + if (host.isNullOrEmpty() || workspaceId.isNullOrEmpty()) { + throw IllegalArgumentException("invalid URI: host or workspaceId is missing: $uri") + } + + try { + URI.create(host) + } catch (e: IllegalArgumentException) { + throw IllegalArgumentException("invalid host: $host") + } + + return ConnectParams(host, workspaceId, debugWorkspace) + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/await.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/await.kt new file mode 100644 index 00000000000000..12e1be26d3b2fd --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/gateway/await.kt @@ -0,0 +1,26 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.gateway + +import kotlinx.coroutines.suspendCancellableCoroutine +import okhttp3.Call +import okhttp3.Callback +import okhttp3.Response +import java.io.IOException + +suspend fun Call.await(): Response = suspendCancellableCoroutine { continuation -> + enqueue(object : Callback { + override fun onResponse(call: Call, response: Response) { + continuation.resumeWith(Result.success(response)) + } + override fun onFailure(call: Call, e: IOException) { + if (continuation.isCancelled) return + continuation.resumeWith(Result.failure(e)) + } + }) + continuation.invokeOnCancellation { + try { cancel() } catch (_: Exception) { } + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/DataManager.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/DataManager.kt new file mode 100644 index 00000000000000..7e4feb841e6463 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/DataManager.kt @@ -0,0 +1,85 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.service + +import io.gitpod.publicapi.v1.WorkspaceOuterClass +import kotlinx.coroutines.Job +import kotlinx.coroutines.channels.BufferOverflow +import kotlinx.coroutines.flow.MutableSharedFlow +import kotlinx.coroutines.launch +import kotlinx.coroutines.sync.Mutex +import kotlinx.coroutines.sync.withLock +import org.slf4j.LoggerFactory +import java.net.SocketTimeoutException + +class DataManager { + val sharedWorkspaceList = MutableSharedFlow>(1, 0, BufferOverflow.DROP_OLDEST) + private val logger = LoggerFactory.getLogger(javaClass) + + private var workspaceList = listOf() + private val workspaceStatusListeners = mutableListOf<(String, WorkspaceOuterClass.WorkspaceStatus) -> Unit>() + + + init { + Utils.coroutineScope.launch { + sharedWorkspaceList.collect { + workspaceList = it + } + } + } + + private var watchWorkspaceStatusJob: Job? = null + private val watchWorkspaceStatusMutex = Mutex() + fun startWatchWorkspaces(publicApi: GitpodPublicApiManager) { + Utils.coroutineScope.launch { + watchWorkspaceStatusMutex.withLock { + try { + publicApi.listWorkspaces().let { + sharedWorkspaceList.tryEmit(it.workspacesList) + } + watchWorkspaceStatusJob?.cancel() + watchWorkspaceStatusJob = publicApi.watchWorkspace(null) { workspaceId, status -> + val found = workspaceList.find { it.id == workspaceId } + if (found != null) { + val newList = workspaceList.map { + if (it.id == workspaceId) { + it.toBuilder().setStatus(status).build() + } else { + it + } + } + sharedWorkspaceList.tryEmit(newList) + } else { + Utils.coroutineScope.launch { + publicApi.listWorkspaces().let { + sharedWorkspaceList.tryEmit(it.workspacesList) + } + } + } + workspaceStatusListeners.forEach{ it(workspaceId, status)} + } + } catch (e: SocketTimeoutException) { + startWatchWorkspaces(publicApi) + } catch (e: Exception) { + logger.error("Error in startWatchWorkspaces", e) + } + } + } + } + + /** + * watchWorkspaceStatus locally to save server load + */ + fun watchWorkspaceStatus(workspaceId: String, consumer: (WorkspaceOuterClass.WorkspaceStatus) -> Unit) { + workspaceList.find { it.id == workspaceId }?.let { + consumer(it.status) + } + workspaceStatusListeners.add { wsId, status -> + if (wsId == workspaceId) { + consumer(status) + } + } + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodConnectionProvider.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodConnectionProvider.kt new file mode 100644 index 00000000000000..ea981091b8920f --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodConnectionProvider.kt @@ -0,0 +1,96 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.service + +import com.jetbrains.rd.util.ConcurrentHashMap +import com.jetbrains.rd.util.URI +import com.jetbrains.toolbox.gateway.ssh.SshConnectionInfo +import io.gitpod.publicapi.v1.WorkspaceOuterClass +import io.gitpod.toolbox.auth.GitpodAuthManager +import kotlinx.serialization.Serializable + +class GitpodConnectionProvider( + private val authManager: GitpodAuthManager, + private val workspaceId: String, + private val publicApi: GitpodPublicApiManager, +) { + private val activeConnections = ConcurrentHashMap() + + suspend fun connect(): Pair Unit> { + val workspace = publicApi.getWorkspace(workspaceId).workspace + val ownerTokenResp = publicApi.getWorkspaceOwnerToken(workspaceId) + val account = authManager.getCurrentAccount() ?: throw Exception("No account found") + + // TODO: debug workspace + val connectParams = ConnectParams(account.getHost(), workspaceId, false) + + val (serverPort, cancel) = tunnelWithWebSocket(workspace, connectParams, ownerTokenResp.ownerToken) + + val connInfo = GitpodWebSocketSshConnectionInfo( + "gitpod", + "localhost", + serverPort, + ) + return (connInfo to cancel) + } + + private fun tunnelWithWebSocket( + workspace: WorkspaceOuterClass.Workspace, + connectParams: ConnectParams, + ownerToken: String, + ): Pair Unit> { + val connectionKeyId = connectParams.uniqueID + + var found = true + activeConnections.computeIfAbsent(connectionKeyId) { + found = false + true + } + + if (found) { + val errMessage = "A connection to the same workspace already exists: $connectionKeyId" + throw IllegalStateException(errMessage) + } + + val workspaceHost = URI.create(workspace.status.workspaceUrl).host + val server = + GitpodWebSocketTunnelServer("wss://${workspaceHost}/_supervisor/tunnel/ssh", ownerToken) + + val cancelServer = server.start() + + return (server.port to { + activeConnections.remove(connectionKeyId) + cancelServer() + }) + } +} + +class GitpodWebSocketSshConnectionInfo( + private val username: String, + private val host: String, + private val port: Int, +) : SshConnectionInfo { + override fun getHost() = host + override fun getPort() = port + override fun getUserName() = username + override fun getShouldAskForPassword() = false + override fun getShouldUseSystemSshAgent() = true +} + +data class ConnectParams( + val gitpodHost: String, + val workspaceId: String, + val debugWorkspace: Boolean = false, +) { + val resolvedWorkspaceId = "${if (debugWorkspace) "debug-" else ""}$workspaceId" + val title = "$resolvedWorkspaceId ($gitpodHost)" + val uniqueID = "$gitpodHost-$workspaceId-$debugWorkspace" +} + +@Serializable +private data class SSHPublicKey( + val type: String, + val value: String +) diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodPublicApiManager.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodPublicApiManager.kt new file mode 100644 index 00000000000000..504878a358d4cc --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodPublicApiManager.kt @@ -0,0 +1,187 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.service + +import com.connectrpc.* +import com.connectrpc.extensions.GoogleJavaProtobufStrategy +import com.connectrpc.http.clone +import com.connectrpc.impl.ProtocolClient +import com.connectrpc.okhttp.ConnectOkHttpClient +import com.connectrpc.protocols.NetworkProtocol +import io.gitpod.publicapi.v1.* +import io.gitpod.toolbox.auth.GitpodAccount +import io.gitpod.toolbox.auth.GitpodAuthManager +import kotlinx.coroutines.Job +import kotlinx.coroutines.launch +import org.slf4j.Logger +import org.slf4j.LoggerFactory +import java.time.Duration + +class GitpodPublicApiManager(private val authManger: GitpodAuthManager) { + private var workspaceApi: WorkspaceServiceClientInterface? = null + private var organizationApi: OrganizationServiceClientInterface? = null + private var userApi: UserServiceClientInterface? = null + private var account: GitpodAccount? = null + private val logger = LoggerFactory.getLogger(javaClass) + + init { + setup() + authManger.addLoginListener { + setup() + } + authManger.addLogoutListener { + workspaceApi = null + organizationApi = null + userApi = null + account = null + } + } + + fun setup() { + val account = authManger.getCurrentAccount() ?: return + this.account = account + logger.debug("setup papi client ${account.getHost()}") + val client = createClient(account.getHost(), account.getCredentials()) + workspaceApi = WorkspaceServiceClient(client) + organizationApi = OrganizationServiceClient(client) + userApi = UserServiceClient(client) + } + + private val orgId: String + get() = account?.organizationId ?: throw IllegalStateException("Organization not selected") + + suspend fun listOrganizations(): List { + val organizationApi = organizationApi ?: throw IllegalStateException("No client") + val resp = organizationApi.listOrganizations(OrganizationOuterClass.ListOrganizationsRequest.newBuilder().build()) + return this.handleResp("listOrganizations", resp).organizationsList + } + + suspend fun createAndStartWorkspace(contextUrl: String, editor: String, workspaceClass: String, configurationId: String?): WorkspaceOuterClass.Workspace { + val workspaceApi = workspaceApi ?: throw IllegalStateException("No client") + val meta = WorkspaceOuterClass.WorkspaceMetadata.newBuilder().setOrganizationId(orgId) + if (configurationId != null) { + meta.setConfigurationId(configurationId) + } + val contextInfo = WorkspaceOuterClass.CreateAndStartWorkspaceRequest.ContextURL.newBuilder() + .setUrl(contextUrl) + .setWorkspaceClass(workspaceClass) + .setEditor(Editor.EditorReference.newBuilder().setName(editor).build()) + val req = WorkspaceOuterClass.CreateAndStartWorkspaceRequest.newBuilder() + .setMetadata(meta) + .setContextUrl(contextInfo) + val resp = workspaceApi.createAndStartWorkspace(req.build()) + return this.handleResp("createWorkspace", resp).workspace + } + + fun watchWorkspace(workspaceId: String?, consumer: (String, WorkspaceOuterClass.WorkspaceStatus) -> Unit): Job { + val workspaceApi = workspaceApi ?: throw IllegalStateException("No client") + return Utils.coroutineScope.launch { + val req = WorkspaceOuterClass.WatchWorkspaceStatusRequest.newBuilder() + if (!workspaceId.isNullOrEmpty()) { + req.setWorkspaceId(workspaceId) + } + val stream = workspaceApi.watchWorkspaceStatus() + stream.sendAndClose(req.build()) + val chan = stream.responseChannel() + try { + for (response in chan) { + consumer(response.workspaceId, response.status) + } + } + finally { + chan.cancel() + } + } + } + + suspend fun listWorkspaces(): WorkspaceOuterClass.ListWorkspacesResponse { + val workspaceApi = workspaceApi ?: throw IllegalStateException("No client") + val resp = workspaceApi.listWorkspaces( + WorkspaceOuterClass.ListWorkspacesRequest.newBuilder().setOrganizationId(orgId).build() + ) + return this.handleResp("listWorkspaces", resp) + } + + suspend fun getWorkspace(workspaceId: String): WorkspaceOuterClass.GetWorkspaceResponse { + val workspaceApi = workspaceApi ?: throw IllegalStateException("No client") + val resp = workspaceApi.getWorkspace( + WorkspaceOuterClass.GetWorkspaceRequest.newBuilder().setWorkspaceId(workspaceId).build() + ) + return this.handleResp("getWorkspace", resp) + } + + suspend fun getWorkspaceOwnerToken(workspaceId: String): WorkspaceOuterClass.GetWorkspaceOwnerTokenResponse { + val workspaceApi = workspaceApi ?: throw IllegalStateException("No client") + val resp = workspaceApi.getWorkspaceOwnerToken( + WorkspaceOuterClass.GetWorkspaceOwnerTokenRequest.newBuilder().setWorkspaceId(workspaceId).build() + ) + return this.handleResp("getWorkspaceOwnerToken", resp) + } + + suspend fun getAuthenticatedUser(): UserOuterClass.User { + return tryGetAuthenticatedUser(userApi, logger) + } + + private fun handleResp(method: String, resp: ResponseMessage): T { + val data = resp.success { it.message } + val error = resp.failure { + logger.error("failed to call papi.${method} $it") + it.cause + } + return data ?: throw error!! + } + + companion object { + fun createClient(gitpodHost: String, token: String): ProtocolClient { + // TODO: 6m? + val client = Utils.httpClient.newBuilder().readTimeout(Duration.ofMinutes(6)).build() + val authInterceptor = AuthorizationInterceptor(token) + return ProtocolClient( + httpClient = ConnectOkHttpClient(client), + ProtocolClientConfig( + host = "$gitpodHost/public-api", + serializationStrategy = GoogleJavaProtobufStrategy(), // Or GoogleJavaJSONStrategy for JSON. + networkProtocol = NetworkProtocol.CONNECT, + interceptors = listOf { authInterceptor } + ), + ) + } + + /** + * Tries to get the authenticated user from the given API client. + * Used in GitpodAuthManager + */ + suspend fun tryGetAuthenticatedUser(api: UserServiceClientInterface?, logger: Logger): UserOuterClass.User { + val userApi = api ?: throw IllegalStateException("No client") + val resp = userApi.getAuthenticatedUser(UserOuterClass.GetAuthenticatedUserRequest.newBuilder().build()) + val user = resp.success { it.message.user } + val err = resp.failure { + logger.error("failed to call papi.getAuthenticatedUser $it") + it.cause + } + return user ?: throw err!! + } + } +} + +class AuthorizationInterceptor(private val token: String) : Interceptor { + override fun streamFunction() = StreamFunction({ + val headers = mutableMapOf>() + headers.putAll(it.headers) + headers["Authorization"] = listOf("Bearer $token") + return@StreamFunction it.clone(headers = headers) + }) + + override fun unaryFunction() = UnaryFunction( + { + val headers = mutableMapOf>() + headers.putAll(it.headers) + headers["Authorization"] = listOf("Bearer $token") + return@UnaryFunction it.clone(headers = headers) + }, + ) +} + +// TODO: logger interceptor diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodWebSocketTunnelServer.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodWebSocketTunnelServer.kt new file mode 100644 index 00000000000000..571c47d89f61c6 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/GitpodWebSocketTunnelServer.kt @@ -0,0 +1,218 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.service + +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.isActive +import kotlinx.coroutines.launch +import org.eclipse.jetty.client.HttpClient +import org.eclipse.jetty.client.HttpProxy +import org.eclipse.jetty.client.Socks4Proxy +import org.eclipse.jetty.util.ssl.SslContextFactory +import org.eclipse.jetty.websocket.jsr356.ClientContainer +import org.slf4j.LoggerFactory +import java.net.* +import java.nio.ByteBuffer +import java.util.* +import java.util.concurrent.CopyOnWriteArrayList +import javax.net.ssl.SSLContext +import javax.websocket.* +import javax.websocket.ClientEndpointConfig.Configurator +import javax.websocket.MessageHandler.Partial + +class GitpodWebSocketTunnelServer( + private val url: String, + private val ownerToken: String, +) { + private val serverSocket = ServerSocket(0) // pass 0 to have the system choose a free port + private val logger = LoggerFactory.getLogger(javaClass) + + val port: Int + get() = serverSocket.localPort + + private fun thisLogger() = logger + + private val clients = CopyOnWriteArrayList() + + fun start(): () -> Unit { + val job = Utils.coroutineScope.launch(Dispatchers.IO) { + thisLogger().info("gitpod: tunnel[$url]: listening on port $port") + try { + while (isActive) { + try { + val clientSocket = serverSocket.accept() + launch(Dispatchers.IO) { + handleClientConnection(clientSocket) + } + } catch (t: Throwable) { + if (isActive) { + thisLogger().error("gitpod: tunnel[$url]: failed to accept", t) + } + } + } + } catch (t: Throwable) { + if (isActive) { + thisLogger().error("gitpod: tunnel[$url]: failed to listen", t) + } + } finally { + thisLogger().info("gitpod: tunnel[$url]: stopped") + } + } + return { + job.cancel() + serverSocket.close() + clients.forEach { it.close() } + clients.clear() + } + } + + private fun handleClientConnection(clientSocket: Socket) { + val socketClient = GitpodWebSocketTunnelClient(url, clientSocket) + try { + val inputStream = clientSocket.getInputStream() + val outputStream = clientSocket.getOutputStream() + + // Forward data from WebSocket to TCP client + socketClient.onMessageCallback = { data -> + outputStream.write(data) + thisLogger().trace("gitpod: tunnel[$url]: received ${data.size} bytes") + } + + connectToWebSocket(socketClient) + + clients.add(socketClient) + + val buffer = ByteArray(1024) + var read: Int + while (inputStream.read(buffer).also { read = it } != -1) { + // Forward data from TCP to WebSocket + socketClient.sendData(buffer.copyOfRange(0, read)) + thisLogger().trace("gitpod: tunnel[$url]: sent $read bytes") + } + } catch (t: Throwable) { + if (t is SocketException && t.message?.contains("Socket closed") == true) { + return + } + thisLogger().error("gitpod: tunnel[$url]: failed to pipe", t) + } finally { + clients.remove(socketClient) + socketClient.close() + } + } + + private fun connectToWebSocket(socketClient: GitpodWebSocketTunnelClient) { + val ssl: SslContextFactory = SslContextFactory.Client() + ssl.sslContext = SSLContext.getDefault() + val httpClient = HttpClient(ssl) + val proxies = Utils.getProxyList() + for (proxy in proxies) { + if (proxy.type() == Proxy.Type.DIRECT) { + continue + } + val proxyAddress = proxy.address() + if (proxyAddress !is InetSocketAddress) { + thisLogger().warn("gitpod: tunnel[$url]: unexpected proxy: $proxy") + continue + } + val hostName = proxyAddress.hostString + val port = proxyAddress.port + if (proxy.type() == Proxy.Type.HTTP) { + httpClient.proxyConfiguration.proxies.add(HttpProxy(hostName, port)) + } else if (proxy.type() == Proxy.Type.SOCKS) { + httpClient.proxyConfiguration.proxies.add(Socks4Proxy(hostName, port)) + } + } + val container = ClientContainer(httpClient) + + // stop container immediately since we close only when a session is already gone + container.stopTimeout = 0 + + // allow clientContainer to own httpClient (for start/stop lifecycle) + container.client.addManaged(httpClient) + container.start() + + // Create config to add custom headers + val config = ClientEndpointConfig.Builder.create() + .configurator(object : Configurator() { + override fun beforeRequest(headers: MutableMap>) { + headers["x-gitpod-owner-token"] = Collections.singletonList(ownerToken) + headers["user-agent"] = Collections.singletonList("gitpod-toolbox") + } + }) + .build() + + try { + socketClient.container = container; + container.connectToServer(socketClient, config, URI(url)) + } catch (t: Throwable) { + container.stop() + throw t + } + } + +} + +class GitpodWebSocketTunnelClient( + private val url: String, + private val tcpSocket: Socket +) : Endpoint(), Partial { + private val logger = LoggerFactory.getLogger(javaClass) + private lateinit var webSocketSession: Session + var onMessageCallback: ((ByteArray) -> Unit)? = null + var container: ClientContainer? = null + + private fun thisLogger() = logger + + override fun onOpen(session: Session, config: EndpointConfig) { + session.addMessageHandler(this) + this.webSocketSession = session + } + + override fun onClose(session: Session, closeReason: CloseReason) { + thisLogger().info("gitpod: tunnel[$url]: closed ($closeReason)") + this.doClose() + } + + override fun onError(session: Session?, thr: Throwable?) { + thisLogger().error("gitpod: tunnel[$url]: failed", thr) + this.doClose() + } + + private fun doClose() { + try { + tcpSocket.close() + } catch (t: Throwable) { + thisLogger().error("gitpod: tunnel[$url]: failed to close socket", t) + } + try { + container?.stop() + } catch (t: Throwable) { + thisLogger().error("gitpod: tunnel[$url]: failed to stop container", t) + } + } + + fun sendData(data: ByteArray) { + webSocketSession.asyncRemote.sendBinary(ByteBuffer.wrap(data)) + } + + fun close() { + try { + webSocketSession.close() + } catch (t: Throwable) { + thisLogger().error("gitpod: tunnel[$url]: failed to close", t) + } + try { + container?.stop() + } catch (t: Throwable) { + thisLogger().error("gitpod: tunnel[$url]: failed to stop container", t) + } + } + + override fun onMessage(partialMessage: ByteBuffer, last: Boolean) { + val data = ByteArray(partialMessage.remaining()) + partialMessage.get(data) + onMessageCallback?.invoke(data) + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/PageRouter.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/PageRouter.kt new file mode 100644 index 00000000000000..d82cb5b0583ede --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/PageRouter.kt @@ -0,0 +1,75 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.service + +import com.jetbrains.toolbox.gateway.ui.LabelField +import com.jetbrains.toolbox.gateway.ui.UiField +import com.jetbrains.toolbox.gateway.ui.UiPage +import org.slf4j.LoggerFactory + +interface Route { + val path: String + val page: UiPage +} + +class PageRouter { + private val logger = LoggerFactory.getLogger(javaClass) + private val history = mutableListOf() + private val routes: MutableList = mutableListOf() + private val listeners: MutableList<(String?) -> Unit> = mutableListOf() + + fun addRoutes(vararg newRoutes: Route) { + logger.info("add routes: {}", newRoutes.map { it.path }) + this.routes.addAll(newRoutes) + } + + fun goTo(path: String) { + val route = routes.find { it.path == path } ?: kotlin.run { + logger.warn("route not found: $path") + return + } + logger.info("go to route: ${route.path}") + history.add(route) + notifyListeners() + } + + fun goBack() { + logger.info("go back") + if (history.size >= 1) { + history.removeAt(history.size - 1) + notifyListeners() + } else { + logger.warn("no route to go back") + return + } + } + + fun getCurrentPage(): Pair { + logger.info("current page: ${history.lastOrNull()?.page}") + val route = history.lastOrNull() ?: return PageNotFound() to true + return route.page to false + } + + fun addListener(listener: (String?) -> Unit): () -> Unit { + listeners.add(listener) + return { + listeners.remove(listener) + } + } + + private fun notifyListeners() { + listeners.forEach { it(history.lastOrNull()?.path) } + } +} + +class PageNotFound : UiPage { + override fun getTitle(): String { + return "Not Found" + } + + override fun getFields(): MutableList { + return mutableListOf(LabelField("Not found")) + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/Utils.kt b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/Utils.kt new file mode 100644 index 00000000000000..05b785e6400084 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/kotlin/io/gitpod/toolbox/service/Utils.kt @@ -0,0 +1,63 @@ +// Copyright (c) 2024 Gitpod GmbH. All rights reserved. +// Licensed under the GNU Affero General Public License (AGPL). +// See License.AGPL.txt in the project root for license information. + +package io.gitpod.toolbox.service + +import com.jetbrains.toolbox.gateway.PluginSettingsStore +import com.jetbrains.toolbox.gateway.ToolboxServiceLocator +import com.jetbrains.toolbox.gateway.connection.ClientHelper +import com.jetbrains.toolbox.gateway.connection.ToolboxProxySettings +import com.jetbrains.toolbox.gateway.ssh.validation.SshConnectionValidator +import com.jetbrains.toolbox.gateway.ui.ObservablePropertiesFactory +import com.jetbrains.toolbox.gateway.ui.ToolboxUi +import kotlinx.coroutines.CoroutineScope +import okhttp3.OkHttpClient +import java.net.Proxy +import java.util.concurrent.atomic.AtomicBoolean + +object Utils { + lateinit var sharedServiceLocator: ToolboxServiceLocator private set + lateinit var coroutineScope: CoroutineScope private set + lateinit var settingStore: PluginSettingsStore private set + lateinit var sshConnectionValidator: SshConnectionValidator private set + lateinit var httpClient: OkHttpClient private set + lateinit var clientHelper: ClientHelper private set + lateinit var observablePropertiesFactory: ObservablePropertiesFactory private set + lateinit var proxySettings: ToolboxProxySettings private set + + lateinit var dataManager: DataManager private set + + lateinit var toolboxUi: ToolboxUi private set + + + fun initialize(serviceLocator: ToolboxServiceLocator) { + if (!isInitialized.compareAndSet(false, true)) { + return + } + sharedServiceLocator = serviceLocator + coroutineScope = serviceLocator.getService(CoroutineScope::class.java) + toolboxUi = serviceLocator.getService(ToolboxUi::class.java) + settingStore = serviceLocator.getService(PluginSettingsStore::class.java) + sshConnectionValidator = serviceLocator.getService(SshConnectionValidator::class.java) + httpClient = serviceLocator.getService(OkHttpClient::class.java) + clientHelper = serviceLocator.getService(ClientHelper::class.java) + observablePropertiesFactory = serviceLocator.getService(ObservablePropertiesFactory::class.java) + proxySettings = serviceLocator.getService(ToolboxProxySettings::class.java) + dataManager = DataManager() + } + + fun openUrl(url: String) { + toolboxUi.openUrl(url) + } + + fun getProxyList(): List { + val proxyList = mutableListOf() + if (proxySettings.proxy != null && proxySettings.proxy != Proxy.NO_PROXY) { + proxyList.add(proxySettings.proxy!!) + } + return proxyList + } + + private val isInitialized = AtomicBoolean(false) +} diff --git a/components/ide/jetbrains/toolbox/src/main/resources/META-INF/services/com.jetbrains.toolbox.gateway.GatewayExtension b/components/ide/jetbrains/toolbox/src/main/resources/META-INF/services/com.jetbrains.toolbox.gateway.GatewayExtension new file mode 100644 index 00000000000000..b225999a57740a --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/resources/META-INF/services/com.jetbrains.toolbox.gateway.GatewayExtension @@ -0,0 +1 @@ +io.gitpod.toolbox.gateway.GitpodGatewayExtension diff --git a/components/ide/jetbrains/toolbox/src/main/resources/dependencies.json b/components/ide/jetbrains/toolbox/src/main/resources/dependencies.json new file mode 100644 index 00000000000000..01b3cbeb86ebf6 --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/resources/dependencies.json @@ -0,0 +1,44 @@ +[ + { + "name": "Toolbox App plugin API", + "version": "2.1.0.16946", + "url": "https://jetbrains.com/toolbox-app/", + "license": "The Apache Software License, Version 2.0", + "licenseUrl": "https://www.apache.org/licenses/LICENSE-2.0.txt" + }, + { + "name": "com.squareup.okhttp3:okhttp", + "version": "4.10.0", + "url": "https://square.github.io/okhttp/", + "license": "The Apache Software License, Version 2.0", + "licenseUrl": "http://www.apache.org/licenses/LICENSE-2.0.txt" + }, + { + "name": "Kotlin", + "version": "1.9.0", + "url": "https://kotlinlang.org/", + "license": "The Apache License, Version 2.0", + "licenseUrl": "http://www.apache.org/licenses/LICENSE-2.0.txt" + }, + { + "name": "kotlinx.coroutines", + "version": "1.7.3", + "url": "https://github.com/Kotlin/kotlinx.coroutines/", + "license": "The Apache License, Version 2.0", + "licenseUrl": "https://github.com/Kotlin/kotlinx.coroutines/blob/master/LICENSE.txt" + }, + { + "name": "kotlinx.serialization", + "version": "1.5.0", + "url": "https://github.com/Kotlin/kotlinx.serialization/", + "license": "The Apache License, Version 2.0", + "licenseUrl": "https://github.com/Kotlin/kotlinx.serialization/blob/master/LICENSE.txt" + }, + { + "name": "org.slf4j:slf4j-api", + "version": "2.0.3", + "url": "http://www.slf4j.org", + "license": "MIT License", + "licenseUrl": "http://www.opensource.org/licenses/mit-license.php" + } +] diff --git a/components/ide/jetbrains/toolbox/src/main/resources/extension.json b/components/ide/jetbrains/toolbox/src/main/resources/extension.json new file mode 100644 index 00000000000000..762823c95e115e --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/resources/extension.json @@ -0,0 +1,20 @@ +{ + "id": "io.gitpod.toolbox.gateway", + "version": "0.0.1", + "meta": { + "readableName": "Gitpod plugin", + "description": "Gitpod CDE(Cloud Development Environment) integration into JetBrains Toolbox App", + "vendor": "Toolbox + Gateway", + "url": "https://github.com/gitpod-io/gitpod", + "backgroundColors": { + "start": { "hex": "#fdb60d", "opacity": 0.6 }, + "top": { "hex": "#ff318c", "opacity": 0.6 }, + "end": { "hex": "#6b57ff", "opacity": 0.6 } + } + }, + "apiVersion": "0.1.0", + "compatibleVersionRange": { + "from": "2.1.0", + "to": "2.2.0" + } +} diff --git a/components/ide/jetbrains/toolbox/src/main/resources/icon.svg b/components/ide/jetbrains/toolbox/src/main/resources/icon.svg new file mode 100644 index 00000000000000..788431d80e068f --- /dev/null +++ b/components/ide/jetbrains/toolbox/src/main/resources/icon.svg @@ -0,0 +1 @@ + diff --git a/components/server/src/oauth-server/db.ts b/components/server/src/oauth-server/db.ts index a6191d504d5dc2..7f1aa17ebba996 100644 --- a/components/server/src/oauth-server/db.ts +++ b/components/server/src/oauth-server/db.ts @@ -141,6 +141,17 @@ const desktopClient: OAuthClient = { ], }; +const toolbox: OAuthClient = { + id: "toolbox-gateway-gitpod-plugin", + name: "JetBrains Toolbox Gitpod Plugin", + redirectUris: ["jetbrains://gateway/io.gitpod.toolbox.gateway/auth"], + allowedGrants: ["authorization_code"], + scopes: [ + // We scope all so that it can work in papi like a PAT + { name: "function:*" }, + ], +}; + const vscode = createVSCodeClient("vscode", "VS Code"); const vscodeInsiders = createVSCodeClient("vscode-insiders", "VS Code Insiders"); @@ -157,6 +168,7 @@ export const inMemoryDatabase: InMemory = { [vscodium.id]: vscodium, [cursor.id]: cursor, [desktopClient.id]: desktopClient, + [toolbox.id]: toolbox, }, tokens: {}, scopes: {},