rofl-docs: Document podman-compose caveats

[matevz]

I tripped up on these two issues:

• compose run - Environment parameters not set in container containers/podman-compose#264: While this works in docker compose:

services:
  oracle:
    environment:
      CONTRACT_ADDRESS: 0x5FbDB2315678afecb367f032d93F642f64180aa3
    entrypoint: /bin/sh -c 'python main.py --network http://sapphire-localnet:8545 --ollama-address http://ollama:11434 --secret 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 $${CONTRACT_ADDRESS}'

The CONTRACT_ADDRESS will be empty in podman-compose. Injecting the variable directly inside entrypoint seems to be the only way currently

services:
  oracle:
    entrypoint: /bin/sh -c 'python main.py --network http://sapphire-localnet:8545 --ollama-address http://ollama:11434 --secret 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 0x5FbDB2315678afecb367f032d93F642f64180aa3'

• Support depends_on type service_completed_successfully containers/podman-compose#575: Waiting for containers to spin up in the correct order with depends_on directive doesn't work. So this oracle:

  oracle:
    environment:
      CONTRACT_ADDRESS: 0x5FbDB2315678afecb367f032d93F642f64180aa3
    build:
      dockerfile: Dockerfile.oracle
        entrypoint: /bin/sh -c 'python main.py --network http://sapphire-localnet:8545 --ollama-address http://ollama:11434 --secret 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 $${CONTRACT_ADDRESS}'
    restart: on-failure
    depends_on:
      contracts:
        condition: service_completed_successfully

will be started prematurely before the contracts are deployed. Adding some sleep can solve the issue:

  oracle:
    build:
      dockerfile: Dockerfile.oracle
    entrypoint: /bin/sh -c 'sleep 100; python main.py --network http://sapphire-localnet:8545 --ollama-address http://ollama:11434 --secret 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 0x5FbDB2315678afecb367f032d93F642f64180aa3'
    restart: on-failure

Document both caveats somewhere at the end of https://docs.oasis.io/build/rofl/app probably?

[kostko]

The above syntax seems incorrect to me, where did you see that $${CONTRACT_ADDRESS} would work? Did you try the regular $CONTRACT_ADDRESS instead?

$ export FOO=3
$ bash -c 'echo $FOO'
3
$ bash -c 'echo $$FOO'
2606301FOO
$ bash -c 'echo $${FOO}'
2606302{FOO}

Because $$ expands to PID.