My Ubuntu environment
Go to file
2022-09-29 13:20:14 +08:00
dotfiles Dotfiles examples 2022-09-28 22:11:55 +08:00
install docker misc 2022-09-29 13:20:14 +08:00
packs Descriptions parsing improved 2022-08-25 22:33:02 +08:00
tools inotifywait-cp 2022-09-28 07:41:07 +08:00
uninstall Makefile generation improved 2022-08-26 08:25:55 +08:00
upgrade Makefile generation improved 2022-08-26 08:25:55 +08:00
.dockerignore Initial docker sandbox 2022-07-04 23:25:31 +08:00
.editorconfig editorconfig 2022-08-19 20:57:45 +08:00
.gitignore inotifywait-cp 2022-09-28 07:41:07 +08:00
Dockerfile Initial docker sandbox 2022-07-04 23:25:31 +08:00
gen-makefile Makefile generation improved 2022-08-26 08:25:55 +08:00
LICENSE Small fixes + WTFPLv2 2022-07-04 23:53:39 +08:00
Makefile KDE Backports 2022-09-28 22:16:12 +08:00
README.md Makefile generation improved 2022-08-26 08:25:55 +08:00

My Ubuntu environment

make-ready bunch of scripts for easily installation of different software.

Requirements

  • Ubuntu >= 20.04 (not tested with version < 20)
  • bash, zsh or other POSIX-compatible shell
  • make (optional but recommended)
  • wget (necessary for some scripts)
  • git (necessary for some scripts)

If some dependecies are missed for some of these scripts it is enougth to run ./install/apt in most cases.

Usage

# if git is installed
git clone git@git.axenov.dev:anthony/my-env.git --depth=1

# if git is not installed
wget -qO - https://git.axenov.dev/anthony/my-env/archive/master.tar.gz | tar -zxf -

# switch to repo dir
cd my-env

# generate fresh ./Makefile and get full list of `make` goals
./gen-makefile

# get full list of `make` goals
make

Selective straightforward installation

# from remote file
wget -qO - https://git.axenov.dev/anthony/my-env/raw/branch/master/install/apt | bash

# from locally cloned repo
./install/apt

How to add my script?

  1. Create a new shell script in ./install, ./upgrade or ./uninstall directory.
    At the beggining of a file you must write these two lines:
    #!/bin/bash
    ##makedesc: Your description for Makefile
    
  2. Make this script executable, e.g.:
    sudo chmod a+x ./install/myscript
    
  3. Test your script
  4. Run make self to generate new ./Makefile

How to create packs?

You can create new file inside ./packs dir.

Syntax is same as classic makefile with one important and necessary addition -- a comment started with ##:

# Pack description
mypack1: goal1 goal2 goalX ...
   ...

# Pack description
mypackX: goalA goalB
   @cp file1 file2
   ...
...

where:

  • mypack* is the pack name
  • goal* are script names in ./install

Note that this is almost useless way to test since you'll meet errors in many cases because dockerized OS is not fully-functional and will never be.

You can use docker to test something really simple, e.g. to check general script steps or install cli tools.

In other cases you need virtualized Ubuntu instead of dockerized one, so I strongly recommend you to use VirtualBox or your host machine.

# switch to repo dir
cd my-env

# build and run container 
docker build -t myenv . && docker run -it myenv

# or oneliner
docker run -it $(docker build -q .)

Now you can play around with scripts.

TODO

License

WTFPLv2