Skip to content

Commit

Permalink
Added text
Browse files Browse the repository at this point in the history
  • Loading branch information
AtibQur committed Jan 8, 2025
1 parent 4ef5bfd commit 2fc5fe7
Showing 1 changed file with 9 additions and 5 deletions.
14 changes: 9 additions & 5 deletions sites/cheerpx/src/content/docs/11-guides/custom-images.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ buildah build -f Dockerfile --platform linux/i386 -t cheerpximage

## 3. Create a container from the Docker Image

Now, create a container from the image using `podman`. Ensure the image name matches the on you built in the previous step.
Now, create a container from the image using `podman`. Ensure the image name matches the one you built in the previous step.

```bash
podman create --name cheerpxcontainer cheerpximage
Expand Down Expand Up @@ -62,7 +62,7 @@ podman unshare mkfs.ext2 -b 4096 -d cheerpXFS/ cheerpXImage.ext2 600M

## 6. Clean up unused resources

After creating your `ext2` image, it's a good practice to clean up unused resources to free up space:
After creating your `ext2` image, it's good practice to clean up unused resources to free up space:

Remove the container:

Expand All @@ -82,9 +82,9 @@ Remove temporary directories:
rm -rf cheerpXFS
```

## Edit `/etc/subgid` (for the host user)
## Optional: edit `/etc/subgid` (for the host user)

The `/etc/subgid` file defines which ranges of subordinate group IDs are allocated to specific user accounts on the host for managing user namespaces in containers. This file needs to be configured for the host user running container commands to ensure proper namespace mapping and avoid conflicts.
The `/etc/subgid` file defines the ranges of subordinate group IDs allocated to specific user accounts on the host for managing user namespaces in containers. This step is **optional** and not necessary for most use cases. However, you may choose to configure it if you encounter namespace-related conflicts.

### 1. Identify your host user

Expand Down Expand Up @@ -122,4 +122,8 @@ If you need to change the `subgid` range for the host user, modify the `start_id
johndoe:200000:65536
```

For more information about `subgid`, refer to the [subgid documententation](https://man7.org/linux/man-pages/man5/subgid.5.html).
For more information about `subgid`, refer to the [subgid documentation](https://man7.org/linux/man-pages/man5/subgid.5.html).

## Conclusion

Congratulations! You have successfully created a custom `ext2` image that can be used as a filesystem for CheerpX. This image is now ready to be loaded into your CheerpX environment for further testing and deployment.

0 comments on commit 2fc5fe7

Please sign in to comment.