klibio / bootstrap

setup scripts for java developer machine

bootstrap developer machine (bndtools, eclipse, java)

quick and easy setup and configuration of

• java LTS releases [8, 11, 17] e.g. set-java.sh 11
• eclipse/oomph installer
• latest eclipse sdk release

on supported os [windows,mac,linux] and arch [arm64,x64] via bash/zsh extension

installation

execute the following script for installation

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/klibio/bootstrap/main/install-klibio.sh)" bash -j -o

installation parameters

# tools
-j                  install java LTS versions
-o                  install eclipse installer / oomph
-e                  install eclipse sdk
# config/tool params
-u                  allow self-signed certificates - curl ignore certs
-f                  force overwrite existing files
-b=<branch_name>    install from a specific branch

usage

using specific Java LTS release

switch to a specific java version with set-java.sh <8|11|17>

$ set-java.sh 11
configure JAVA_HOME=/c/Users/peter/.klibio/java/ee/JAVA11
openjdk version "11.0.18" 2023-01-17
OpenJDK Runtime Environment Temurin-11.0.18+10 (build 11.0.18+10)
OpenJDK 64-Bit Server VM Temurin-11.0.18+10 (build 11.0.18+10, mixed mode)

oomph / eclipse-installer

option 1 - launch oomph / eclipse installer

$ start-klibio.sh -o
# launching oomph in separate window

option 2 - launch oomph with a specific config

launch oomph with a specific config start-klib.io -o=https://<host>/<org>/<repo>

$ start-klibio.sh -o=https://github.com/klibio/bootstrap
# launching oomph in separate window with config https://raw.githubusercontent.com/klibio/bootstrap/feature/x/oomph/config/cfg_github.com_klibio_bootstrap.setup

1. Checks if there is an existing configuration file available.
2. Opens a oomph gui installer pre-selecting the product and the github project from klibio organisation.
3. Provide the Installation folder name and press Next > and then Finish to get the Eclipse IDE installed with the repository checked out and imported.
4. Your are ready to code ...

implementation

• minimal host changes
  • additions in ~/.bashrc ( or ~/.zshrc on OSX )
  • local folder ~/.klibio
• idempotent execution

links

• FAQ
• Glossary
• LICENSE

bootstrap's Issues

full qualified template and project names

./generate-commit.sh -o=https://github.com/klibio

parse server and org (require "server" token

general pattern for filenames: <type>_<server>_<org>_<project>

template

/bootstrap/oomph/template/github_config_template.setup -> /bootstrap/oomph/template/template_github.com_cfg.setup
/bootstrap/oomph/template/github_project_template.setup ->/bootstrap/oomph/template/template_github.com_prj.setup

generated cfg

https://github.com/klibio/bootstrap -> bootstrap/oomph/config/cfg_github.com_klibio_bootstrap
https://gitlab.klib.io/dev/io.klib.gridjs -> bootstrap/oomph/config/cfg_gitlab.klib.io_dev_io.klib.gridjs

generate project (server url -> filename inside project folder)

https://github.com/klibio/bootstrap -> bootstrap/oomph/projects/prj_github.com_klibio_bootstrap
https://gitlab.klib.io/dev/io.klib.gridjs -> bootstrap/oomph/projects/prj_gitlab.klib.io_dev_io.klib.gridjs

Enhance template to generate gitlab.klib.io/dev projects

1. template gitlab based on oomph\config\cfg_dev_osgi-demo.setup and oomph\projects\dev_osgi-demo.setup
2. enhance prepare-commit.sh
   to accept -o=
   valid are e.g. https://github.com/klibio, https://gitlab.klib.io/dev
   parse server github.com or gitlab.klib.io
   parse git_org e.g. klibio or dev
   use corresponding template for generation of target git server
   curl command to get ID based on group name

see doc\gitlab.md for acessing

When executing the curl command on a completely fresh install of windows, some shared libraries for htmlq are missing

Executing the curl results in errors

#
# configure klibio extension inside ~/.bashrc
#
using available curl
using jq-1.6
C:/Users/aschi/.klibio/tool/htmlq.exe: error while loading shared libraries: api-ms-win-crt-heap-l1-1-0.dll: cannot open shared object file: No such file or directory
      using
skip eclipse provisioning
#
# provision java start
#
using available curl
using jq-1.6
C:/Users/aschi/.klibio/tool/htmlq.exe: error while loading shared libraries: api-ms-win-crt-heap-l1-1-0.dll: cannot open shared object file: No such file or directory
      using

Maybe we should include them in the tools lib?