# Packaging OpenG2P Docker

This page contains steps to be performed for packaging different components and addons, of OpenG2P and similar, into a docker image.

## Instructions

* Clone the <https://github.com/OpenG2P/openg2p-packaging>  and go to [packaging](https://github.com/OpenG2P/openg2p-packaging/tree/develop/packaging) directory
* Create text file, example `my-package.txt` . This signifies a package. This file should include all openg2p modules (repositories) to be packaged into a new docker. Each line describes one repository to include, and the structure of each line looks like this.

  ```
  repo_name = git://<github branch name>//<github url to pull from>
  repo2_name = file://<path of the package in local system>
  ```

  * Any underscore in the repository name will be converted to hyphen during installation. For example:

    ```
    repo_name = git://<github branch name>//<github url to pull from>
    ```

    This is internally converted to `repo-name`.
* The above configuration can be made via environment variables also.
  * Any variable with the prefix `G2P_PACKAGE_my_package_` will be considered as repository to install i.e., `G2P_PACKAGE_<package_name>_<repo_name>`. For example;

    ```
    G2P_PACKAGE_my_package_repo3_name=git://<github branch name>//<github url to pull from>
    ```
  * These env variables can be added in `.env` file (in the same folder). The `.env` file will automatically be considered.
  * If same package is available in `my-package.txt`, `.env` and environment variable, then this will be the preference order in which they are considered (highest to lowest).
    * `.env` file
    * Environment variable.
    * `my-package.txt`
  * Use the `.env` to overload packages from `my-package.txt`
* Run the following to download all packages:

  ```
  ./package.sh my-package.txt
  ```
* After downloading packages, run the following to build docker image:

  ```
  docker build . -t <docker image name>
  ```
* Then push the image.

  ```
  docker push <docker image name>
  ```
* Notes:
  * The above uses bitnami's odoo image as base.
  * This script also pulls in any OCA dependencies configured, in `oca_dependencies.txt` inside each package. Use this env variable to change the version of OCA dependencies to be pulled, `OCA_DEPENDENCY_VERSION` (defaults to `15.0`).
  * This also installs any python requirements configured in `requirements.txt` inside each package.
  * Reference packages can be found in packages directory inside packaging directory.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openg2p.org/1.0.0/guides/deployment-guide/packaging-openg2p-docker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.