Coder Gateway Plugin

Coder Gateway connects your Jetbrains IDE to your Coder Workspaces so that you can develop from anywhere.

Manage less

Ensure your entire team is using the same tools and resources
Keep your source code and data behind your firewall

Code more

Build and test faster
- Leveraging cloud CPUs, RAM, network speeds, etc.
Access your environment from any place
Onboard instantly then stay up to date continuously

Getting Started

To manually install a local build:

Install Jetbrains Gateway
run ./gradlew clean buildPlugin to generate a zip distribution
locate the zip file in the build/distributions folder and follow these instructions on how to install a plugin from disk.

Alternatively, ./gradlew clean runIde will deploy a Gateway distribution (the one specified in gradle.properties - platformVersion) with the latest plugin changes deployed.

Plugin Structure

├── .github/                GitHub Actions workflows and Dependabot configuration files
├── gradle
│   └── wrapper/            Gradle Wrapper
├── build/                  Output build directory
├── src                     Plugin sources
│   └── main
│       ├── kotlin/         Kotlin production sources
│       └── resources/      Resources - plugin.xml, icons, i8n
│   └── test
│       ├── kotlin/         Kotlin test sources
├── .gitignore              Git ignoring rules
├── build.gradle.kts        Gradle configuration
├── CHANGELOG.md            Full change history
├── gradle.properties       Gradle configuration properties
├── gradlew                 *nix Gradle Wrapper script
├── gradlew.bat             Windows Gradle Wrapper script
├── qodana.yml              Qodana profile configuration file
├── README.md               README
└── settings.gradle.kts     Gradle project settings

src directory is the most important part of the project, the Coder Gateway implementation and the manifest for the plugin – plugin.xml.

Gradle Configuration Properties

The project-specific configuration file gradle.properties contains:

Property name	Description
`pluginGroup`	Package name, set to `com.coder.gateway`.
`pluginName`	Zip filename.
`pluginVersion`	The current version of the plugin in SemVer format.
`pluginSinceBuild`	The `since-build` attribute of the `<idea-version>` tag. The minimum Gateway build supported by the plugin
`pluginUntilBuild`	The `until-build` attribute of the `<idea-version>` tag. Supported Gateway builds, until & not inclusive
`platformType`	The type of IDE distribution, in this GW.
`platformVersion`	The version of the Gateway used to build&run the plugin.
`platformDownloadSources`	Gateway sources downloaded while initializing the Gradle build. Note: Gateway does not have open sources
`platformPlugins`	Comma-separated list of dependencies to the bundled Gateway plugins and plugins from the Plugin Repositories.
`javaVersion`	Java language level used to compile sources and generate the files for - Java 11 is required since 2020.3.
`gradleVersion`	Version of Gradle used for plugin development.

The properties listed define the plugin itself or configure the gradle-intellij-plugin – check its documentation for more details.

Testing

No functional or UI tests are available yet.

Code Monitoring

Code quality is monitored with the help of Qodana

Qodana inspections are accessible within the project on two levels:

using the [Qodana IntelliJ GitHub Action][docs:qodana-github-action], run automatically within the Build workflow,
with the Gradle Qodana Plugin, so you can use it on the local environment or any CI other than GitHub Actions.

Qodana inspection is configured with the qodana { ... } section in the Gradle build file and qodana.yml YAML configuration file.

NOTE: Qodana requires Docker to be installed and available in your environment.

To run inspections, you can use a predefined Run Qodana configuration, which will provide a full report on http://localhost:8080, or invoke the Gradle task directly with the ./gradlew runInspections command.

A final report is available in the ./build/reports/inspections/ directory.

Plugin compatibility

./gradlew runPluginVerifier can check the plugin compatibility against the specified Gateway. The integration with Github Actions is commented until this gradle intellij plugin issue is fixed.

Continuous integration

In the .github/workflows directory, you can find definitions for the following GitHub Actions workflows:

Build
- Triggered on push and pull_request events.
- Runs the Gradle Wrapper Validation Action to verify the wrapper's checksum.
- Runs the verifyPlugin and test Gradle tasks.
- Builds the plugin with the buildPlugin Gradle task and provides the artifact for the next jobs in the workflow.
- ~~Verifies the plugin using the IntelliJ Plugin Verifier tool.~~ (this is commented until this issue is fixed)
- Prepares a draft release of the GitHub Releases page for manual verification.
Release
- Triggered on Publish release event.
- Updates CHANGELOG.md file with the content provided with the release note.
- Pat

License

coder/jetbrains-coder

ErrorLooks like something went wrong!

About

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases 59

Packages 0

Contributors 18

Languages

Error
Looks like something went wrong!

Packages