| OLD | NEW |
| 1 # Running the engine in a Docker container | 1 # Running the engine in a Docker container |
| 2 | 2 |
| 3 For local development and testing, you can run the engine in a Docker | 3 For local development and testing, you can run the engine in a Docker |
| 4 container. | 4 container. |
| 5 | 5 |
| 6 The steps are: | 6 The steps are: |
| 7 | 7 |
| 8 1. Bundle the engine and its dependencies. | 8 1. Bundle the engine and its dependencies. |
| 9 | 9 |
| 10 1. Build a Docker image. | 10 1. Build a Docker image. |
| (...skipping 21 matching lines...) Expand all Loading... |
| 32 ## Bundle Engine | 32 ## Bundle Engine |
| 33 | 33 |
| 34 The `blimp/engine:blimp_engine_bundle` build target will bundle the engine and | 34 The `blimp/engine:blimp_engine_bundle` build target will bundle the engine and |
| 35 its dependencies into a tarfile, which can be used to build a Docker image. | 35 its dependencies into a tarfile, which can be used to build a Docker image. |
| 36 This target is always built as part of the top-level `blimp/blimp` meta-target. | 36 This target is always built as part of the top-level `blimp/blimp` meta-target. |
| 37 | 37 |
| 38 ### Update Engine Dependencies | 38 ### Update Engine Dependencies |
| 39 | 39 |
| 40 `blimp/engine/engine-manifest.txt` is a list of the engine's runtime | 40 `blimp/engine/engine-manifest.txt` is a list of the engine's runtime |
| 41 dependencies. From time to time, this list may need to be updated. Use | 41 dependencies. From time to time, this list may need to be updated. Use |
| 42 `blimp/tools/generate-engine-manifest.py` to (re)generate the manifest: | 42 `blimp/tools/generate-manifest.py` to (re)generate the manifest: |
| 43 | 43 |
| 44 ```bash | 44 ```bash |
| 45 ./blimp/tools/generate-engine-manifest.py \ | 45 ./blimp/tools/generate-manifest.py \ |
| 46 --build-dir out-linux/Debug \ | 46 --build-dir out-linux/Debug \ |
| 47 --target //blimp/engine \ | 47 --target //blimp/engine \ |
| 48 --output blimp/engine/engine-manifest.txt | 48 --output blimp/engine/engine-manifest.txt \ |
| 49 --blacklist blimp/tools/manifest-blacklist.txt |
| 49 ``` | 50 ``` |
| 50 | 51 |
| 51 Be sure to review the generated manifest and remove any false runtime | 52 Be sure to review the generated manifest and remove any false runtime |
| 52 dependencies. | 53 dependencies. |
| 53 | 54 |
| 54 For all entries listed in the manifest that are not from | 55 For all entries listed in the manifest that are not from |
| 55 `//third_party/blimp_fonts`, ensure that the target that generate that artifact | 56 `//third_party/blimp_fonts`, ensure that the target that generate that artifact |
| 56 is manually listed as a dependency of `//blimp/engine:blimp_engine_bundle` to | 57 is manually listed as a dependency of `//blimp/engine:blimp_engine_bundle` to |
| 57 ensure that it is built before the bundle step happens. | 58 ensure that it is built before the bundle step happens. |
| 58 | 59 |
| (...skipping 34 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 93 ```bash | 94 ```bash |
| 94 docker run -v $CONFIG_DIR:/engine/data -p 443:25466 blimp_engine | 95 docker run -v $CONFIG_DIR:/engine/data -p 443:25466 blimp_engine |
| 95 ``` | 96 ``` |
| 96 You can also pass additional flags: | 97 You can also pass additional flags: |
| 97 | 98 |
| 98 ```bash | 99 ```bash |
| 99 docker run ... blimp_engine --with-my-flags | 100 docker run ... blimp_engine --with-my-flags |
| 100 ``` | 101 ``` |
| 101 See the [blimp engine `Dockerfile`](../engine/Dockerfile) to find out what flags | 102 See the [blimp engine `Dockerfile`](../engine/Dockerfile) to find out what flags |
| 102 are passed by default. | 103 are passed by default. |
| OLD | NEW |