Developer Walkthrough and Project Setup

Prerequisites

Git
Bash shell (tested on Github Codespaces, Mac, Ubuntu, Windows with WSL2)
- Will not work in Cloud Shell or WSL1
Docker (download)
Java 11+ (download)
Maven (download)
Powershell (optional) (download)

git clone https://github.com/microsoft/kafka-connect-cosmosdb.git

Configure IDE to use a JDK by one of the following way.
- Setting the value of the JAVA_HOME system environment variable to the install location of the JDK, for example, C:\Program Files\Java\jdk-13.0.2.
- if you want to configure only VS Code to use the JDK, use the java.home setting in VS Code's User or Workspace settings
Download maven dependencies.

Open the Github repo in a web browser
- kafka-connect-cosmosdb
Click on the Code button
Click on Open with Codespaces
Click on the New codespace button
Codespaces will display a Creation Log window
- You may close this window once all the steps have completed
Open a terminal in Codespaces
- Use the command palette or press ctl + `
- You can also click on the Menu button in the upper left corner
  - choose view
  - choose terminal

Navigate to root project directory and execute unit tests

cd kafka-connect-cosmosdb
mvn clean test

Integration tests are being reworked. These will be added soon.