Skip to main content

Developer Tools

Development environment​

Open Earth Community/OEC, accessed via Amazon Workspaces - Download client.

!! Always run programs as Administrator within the workspace !!

Users can install their own tools as needed. For ease of use, you can install Chocolatey.

winget is not available as this is an older Server OS

The following tools are all to be installed on the Workspace machines

Backlog tool workaround​

Azure DevOps/ADO Boards needs to be accessed via Windows Virtual Desktop / WVD or by performing this workaround:

  1. Chose whatever backlog you want to access, at the halliburton login page
  2. F12 -> DevTools -> Network Tab -> Network conditions
  3. image
  4. image
  5. Refresh the page
  6. Login
  7. Profit

or just use this extension

IDE​

IntelliJ is used for Java development (license available through Sopra Steria)

Visual Studio Code is preferred for javascript development

or

choco install vscode

Extensions​

  • Angular Language Service
  • GitLab Workflow
  • GitHub Copilot (you can request access via AkerBP GitHub) Request access here

Other tools​

SSH Client​

Used to connect to various servers to run kubectl etc.

MobaXterm

git​

Download git

choco install git

Some settings that could be useful

# Set username and email
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
# Use credential manager (optional)
git config --global credential.helper wincred
# VSCode as default git editor
git config --global core.editor "code --wait"

# Set VSCode as the default merge tool
git config --global merge.tool vscode
git config --global mergetool.vscode.cmd 'code --wait "$MERGED"'

# Optionally, set VSCode as the default diff tool
git config --global diff.tool vscode
git config --global difftool.vscode.cmd 'code --wait --diff "$LOCAL" "$REMOTE"'
# Some repos have extremely long paths
git config --global core.longpaths true

using ssh with git​

# Configures Git to explicitly use the same SSH binary as Windows, ensuring consistent key management and avoiding repeated passphrase prompts.
git config --global core.sshCommand (get-command ssh).Source.Replace('\','/')

# Setup your ssh-agent to run on startup and start it manually
Set-Service -Name ssh-agent -StartupType Automatic
Start-Service ssh-agent

Guide for setting up with gitlab

tldr:

# Make public and private key
ssh-keygen -t ed25519 -C "<your email>"

# Add key for smooth key managment
ssh-add ~/.ssh/<your key>.pub

# Output similar to the following is displayed, accept the suggested filename and directory.
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/user/.ssh/id_ed25519):

# Specify a passphrase if you want:
Enter passphrase (empty for no passphrase):
Enter same passphrase again:

# Copy public key to your clipboard (it will work but gives no feedback)
cat ~/.ssh/<your key>.pub | clip

Finally:

  1. Sign in to GitLab.
  2. On the left sidebar, select your avatar.
  3. Select Edit profile.
  4. On the left sidebar, select SSH Keys.
  5. Select Add new key.
  6. In the Key box, paste the full contents of your public key file.
  7. In the Title box, type a description, like Work Laptop or Home Workstation.
  8. Select Add key.

ripgrep (grep for windows)​

choco install ripgrep
# Example recursive grep
rg "searchterm" #
# Example chained
cat .\file.ts | grep "searchterm"
# Example recursive grep
rg "searchterm" #
# Example chained
cat .\file.ts | grep "searchterm"

fnm​

https://github.com/Schniz/fnm

Useful for installing, switching between different nodejs versions etc.

Download fnm

choco install fnm

Angular 10 projects​

fnm install v14.21.3

Angular 16+ projects​

fnm install v16.20.0

Simple usage​

#See installed versions
fnm list 
#See available versions
fnm list-remote
#Switch between versions
fnm use 14.21.3

Debugging Angular​

Just use Chrome DevTools -> Ctrl + P > Search for the file > Set a breakpoint

In newer versions they've changed the bundling, so you need to find the bundle file and search for a unique line of code, set a break

Oh My Posh (Optional)​

For a better powershell experience

Fresh terminal

Installing Terminal in Amazon Workspace​

  • Download VCLibs 14.00 Info
  • Download the latest stable 2.8.x version of UI Xaml Releases
  • Download the latest stable version of Windows Terminal Releases
# Open powershell and navigate to the download destination
cd <your download folder path>

# Install the packages we downloaded
Add-AppxPackage .\Microsoft.VCLibs <tab>
Add-AppxPackage .\Microsoft.UI.Xaml <tab>
Add-AppxPackage .\Microsoft.WindowsTerminal <tab>

# Complete! You can now open terminal like normal

Or just use git-bash

Connecting...