PiotrJustyna / argon

minimal development environment

• argon
  • features
  • manifesto
  • host requirements
  • how to
    • start
    • stop
    • customisation
      • ARG
      • volumes
  • examples
  • resources

argon

Minimal dotnet development environment.

Build and run your code in a container exposing an interactive bash shell. It looks like your regular shell, but everything is installed and running in a docker container. When you're done, simply exit argon shell to get back to your regular shell.

features

• alpine 3.19 base
• zsh + oh my zsh
• .net 7.0 sdk as an apk package (earlier versions of argon used the microsoft .net 8.0 sdk alpine base image which came with dotnet pre-installed)
• markdwn
  • pandoc
  • mermaid
  • pdflatex (via texlive)
  • marp

manifesto

• *lean and **quiet development environment
• take your development environment anywhere
• low expectations from your text editor - keep it:
  • vanilla
  • removed from the equation
• reuse host's ssh keys

---

• *lean - minimal number of unused components
• **quiet - minimal number of errors

host requirements

• docker

how to

start

./start.sh

stop

exit

customisation

ARG

• $USER_NAME - controls the name of the default account controlling the development environment. Possible values:
  • root - default value, root will be the default user acount
  • [any other value] - will result in creating argon-development-group group and a non-root default member account named [any other value]

volumes

• $CERTIFICATE_DIRECTORY - host's .ssh directory. This is useful for upstream git operations.

examples

See this repository: https://github.com/PiotrJustyna/argon-examples

resources

• text to ascii art generator
• github wiki toc generator