https://github.com/siakhooi/image-sitter
collection of bash scripts to maintain docker images.
https://github.com/siakhooi/image-sitter
active apt bash
Last synced: 7 days ago
JSON representation
collection of bash scripts to maintain docker images.
- Host: GitHub
- URL: https://github.com/siakhooi/image-sitter
- Owner: siakhooi
- License: mit
- Created: 2023-02-14T12:12:59.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2026-06-03T02:34:24.000Z (22 days ago)
- Last Synced: 2026-06-03T04:22:36.137Z (22 days ago)
- Topics: active, apt, bash
- Language: Shell
- Homepage:
- Size: 4.04 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Image Sitter
Programs to take care of your container images. It helps to ensure you have an up to date local cache of the docker images that are frequently used.
## Introduction
By maintaining the docker url in several files, categorize into groups, and 3 predefined subgroups, which are 'pull-always', 'pull-if-not-exists', and 'delete-if-exists'.
`image-sitter` programs will do the necessary pull or delete when they are triggered.
## Format of files
- Each line of a file is a docker url, such as: nginx:latest.
- lines started with # will be ignored.
- blank lines will also be ignored.
## Commands
```bash
image-sitter-init group
image-sitter group [group ...]
image-sitter-pull-always group [group ...]
image-sitter-pull-if-not-exists group [group ...]
image-sitter-delete-if-exists group [group ...]
```
## Sample
## Quick Start
### Installation
- Pre-requisite
- yq
- docker
```bash
$ sudo curl -L https://siakhooi.github.io/apt/siakhooi-apt.list | sudo tee /etc/apt/sources.list.d/siakhooi-apt.list > /dev/null
$ sudo curl -L https://siakhooi.github.io/apt/siakhooi-apt.gpg | sudo tee /usr/share/keyrings/siakhooi-apt.gpg > /dev/null
$ sudo apt update
$ sudo apt install siakhooi-image-sitter
```
- To setup bash completion, add the following code in `~/.bashrc` file.
```bash
source <(image-sitter-completion)
```
### Using Image Sitter
```bash
# create the group
image-sitter-init quick-start-1
# pull images
image-sitter quick-start-1
```
## Directory structure
```txt
~/.image-sitter/
+ group1/
+ pull-always/
+ file1.txt
+ file2.txt
+ ...
+ pull-if-not-exists/
+ file1.txt
+ file2.txt
+ ...
+ delete-if-exists/
+ file1.txt
+ file2.txt
+ ...
+ group2/
+ pull-always/
+ file1.txt
+ file2.txt
+ ...
+ pull-if-not-exists/
+ file1.txt
+ file2.txt
+ ...
+ delete-if-exists/
+ file1.txt
+ file2.txt
+ ...
+ ...
```
## Deployments
-
## Badges
[](https://www.buymeacoffee.com/siakhooi)
[](https://ko-fi.com/siakhooi)
