update documentation

recipe/index.txt

@@ -2,7 +2,7 @@ helloworld.yaml
 hello
 pipeline
 app/container/redbean
-extract/rollback_simple
+checkout/rollback_simple
 init/server/sshkey
 init/gitops/jail
 start/envfile
@@ -12,3 +12,4 @@ run/container_autosuspend
 run/baremetal_webcli
 run/baremetal
 run/container_webcli
+run/container_compose

recipe/run/baremetal

@@ -1,6 +1,4 @@
-# info:          simple app template 
-# installation:  run 'podi recipe app/simple' or put this file into .pod folder 
-# example usage: ./podman rollback git@server 3fe2f615
+# info:          baremetal template, perfect to run background services on lowend systems
 
 daemonize(){
   kill -0 $(cat .pid)

recipe/run/baremetal_autosuspend

@@ -1,6 +1,4 @@
-# info:          simple app template which suspends/activates based on port-traffic 
-# installation:  run 'podi recipe app/simple_autosuspend' or put this file into .pod folder 
-# example usage: ./podman rollback git@server 3fe2f615
+# info:          baremetal template, perfect for port-activated services on lowend systems
 
 daemonize(){
   while sleep 0.2s; do 

recipe/run/baremetal_webcli

@@ -1,6 +1,4 @@
-# info:          simple app template 
-# installation:  run 'podi recipe app/simple' or put this file into .pod folder 
-# example usage: ./podman rollback git@server 3fe2f615
+# info:          baremetal cli-template, perfect for outputting terminal-cmds to web
 
 daemonize(){
   while sleep 1s; do 

recipe/run/container

@@ -1,3 +1,5 @@
+# info:          containerized app, nice starting point for Dockerfile + app 
+
 export POD=$(which podman || which docker || echo "")
 
 hint_systemd(){

recipe/run/container_autosuspend

@@ -1,3 +1,5 @@
+# info:          containerized port-activated app, nice starting point for Dockerfile + app 
+
 export POD=$(which podman || which docker || echo "")
 
 hint_systemd(){

recipe/run/container_compose

@@ -0,0 +1,56 @@
+# info:          containerized stack, nice startingpoint using docker-compose.yml 
+
+export POD=$(which podman-compose || which docker-compose)
+
+build(){
+  header .pod/app/container-compose
+  test -f docker-compose.yml || { print "'docker-compose.yml' not found..skipping build"; }
+  test -f docker-compose.yml && {
+    silent which $POD || print '[!] please install podman-compose (or docker-compose)'
+    silent which $POD && verbose $POD build
+  } | soften 
+  return 0
+}
+
+stop(){
+  test -z $POD || verbose $POD down
+}
+
+start(){
+  header .pod/app/container
+  silent which $POD || error "please install podman-compose (or docker-compose)"
+  test -z $POD || {
+    export PODI_APP=$PODI_APP
+    eval "$(cat .env)"
+    verbose $POD up -d
+    verbose $POD logs
+    print ""
+    print "your container(s) is running at $PODI_REMOTE:$PORT"
+  } 
+  return 0
+}
+
+init_runtime(){
+  test -f docker-compose || {
+    generate(){ 
+      echo 'version: "3.9"'
+      echo 'services:'
+      echo '  web:'
+      echo '    image: docker.io/coderofsalvation/redbean:1.5'
+      echo '    command: /redbean.com -D /app'
+      echo '    volumes:'
+      echo '      - .:/app'
+      echo '    ports:'
+      echo '      - "${PORT}:8080"'
+    }
+    PORT=$(awk 'BEGIN{ srand(); print int(rand()*1000)+8000 }')
+    prompt "generate + commit 'docker-compose.yml' file?" "$(generate | soften)" "[y/n] "
+    generate > docker-compose.yml
+    test $answer = "y" || error aborting
+    echo "export PORT=$PORT" >> .env 
+    git add docker-compose.yml .env .pod podi && git commit -m "adding podi"
+  }
+  test -f .pod/checkout/rollback_simple || recipe checkout/rollback_simple
+  test -f .pod/start/envfile            || recipe start/envfile 
+  test -f .pod/init/server/sshkey       || recipe init/server/sshkey 
+}

recipe/run/container_webcli

@@ -1,3 +1,5 @@
+# info:          containerized cli-template, perfect for outputting terminal-cmds to web
+
 export POD=$(which podman  || which docker || echo "")
 
 hint_systemd(){

recipe/start/envfile

@@ -26,6 +26,6 @@ envset(){ # envset [git@server] [app] [FOO=bar] : shows or sets [remote] environ
   fi
 }
 
-on start envfile
+on build envfile
 on checkout envfile 
 on init_runtime ensure_file_env