docs: custom apps with podman
This commit is contained in:
@@ -67,6 +67,7 @@ If you ran in a Dev Docker environment, to view container logs: `docker compose
|
||||
### [Custom Images](#custom-images)
|
||||
|
||||
- [Custom Apps](docs/custom-apps.md)
|
||||
- [Custom Apps with podman](docs/custom-apps-podman.md)
|
||||
- [Build Version 10 Images](docs/build-version-10-images.md)
|
||||
|
||||
### [Development](#development)
|
||||
|
||||
@@ -1,4 +1,5 @@
|
||||
## Prerequisites
|
||||
|
||||
- podman
|
||||
- podman-compose
|
||||
- docker-compose
|
||||
@@ -6,12 +7,15 @@
|
||||
Podman (the POD MANager) is a tool for managing containers and images, volumes mounted into those containers, and pods made from groups of containers. It is available on the official repositories of many Linux distributions.
|
||||
|
||||
## Step 1
|
||||
|
||||
- Clone this repository and change the current directory to the downloaded folder
|
||||
```cmd
|
||||
git clone https://github.com/frappe/frappe_docker
|
||||
cd frappe_docker
|
||||
```
|
||||
|
||||
## Step 2
|
||||
|
||||
- Create `apps.json` file with custom apps listed in it
|
||||
```json
|
||||
[
|
||||
@@ -34,7 +38,9 @@ Podman (the POD MANager) is a tool for managing containers and images, volumes m
|
||||
`cmd export APPS_JSON_BASE64=$(base64 -w 0 apps.json)`
|
||||
|
||||
## Step 3
|
||||
|
||||
- Building the custom image using podman
|
||||
|
||||
```ruby
|
||||
podman build \
|
||||
--build-arg=FRAPPE_PATH=https://github.com/frappe/frappe \
|
||||
@@ -43,10 +49,13 @@ Podman (the POD MANager) is a tool for managing containers and images, volumes m
|
||||
--tag=custom:15 \
|
||||
--file=images/layered/Containerfile .
|
||||
```
|
||||
|
||||
### Note
|
||||
|
||||
- Make sure to use the same tag when you export a variable on the next step
|
||||
|
||||
## Step 4
|
||||
|
||||
- Using the image
|
||||
- Export environment variables with image name, tag and pull_policy
|
||||
```ruby
|
||||
@@ -55,9 +64,10 @@ Podman (the POD MANager) is a tool for managing containers and images, volumes m
|
||||
export PULL_POLICY=never
|
||||
```
|
||||
- Configuration of parameters used when starting the containers
|
||||
- create `.env` file copying from example.env (Read more on setting up environemnt variables [here](https://github.com/frappe/frappe_docker/blob/main/docs/environment-variables.md)
|
||||
- create `.env` file copying from example.env (Read more on setting up environment variables [here](https://github.com/frappe/frappe_docker/blob/main/docs/environment-variables.md)
|
||||
|
||||
## Final step
|
||||
|
||||
- Creating a compose file
|
||||
- ```ruby
|
||||
podman compose -f compose.yaml \
|
||||
@@ -72,20 +82,21 @@ Podman (the POD MANager) is a tool for managing containers and images, volumes m
|
||||
- `podman-compose --in-pod=1 --project-name erpnext -f ./docker-compose.yml up -d`
|
||||
|
||||
## Creating sites and installing apps
|
||||
|
||||
- You can create sites from the backend container
|
||||
- `podman exec -ti erpnext_backend_1 /bin/bash`
|
||||
- `bench new-site myerp.net --mariadb-root-password 123456 --admin-password 123123`
|
||||
- `bench --site myerp.net install-app erpnext`
|
||||
|
||||
## Troubleshoot
|
||||
|
||||
- If there is a network issue while building the image, you need to remove caches and restart again
|
||||
|
||||
- `podman system reset`
|
||||
- `sudo rm -rf ~/.local/share/containers/ /var/lib/container ~/.caches/containers`
|
||||
|
||||
- Database issue when restarting the container
|
||||
- Execute the following commands from **backend** container
|
||||
- `mysql -uroot -padmin -hdb` (Note: put your db password in place of *admin*).
|
||||
- `mysql -uroot -padmin -hdb` (Note: put your db password in place of _admin_).
|
||||
- `SELECT User, Host FROM mysql.user;`
|
||||
- Change the IP address to %, e.g. `RENAME USER '_5e5899d8398b5f7b'@'172.18.0.7' TO '_5e5899d8398b5f7b'@'%'`
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user