Re: sysutils/docker-cli: add readme

On Fri, 13 Dec 2024 20:55:56 +0100,
Kirill A. Korinsky <kirill@korins.ky> wrote:
>
> ports@,
>
> I'd like to add readme to sysutils/docker-cli where I explain how to
> organize an expected setup with sharing of some directories into docker.
>

Anyone?

Index: sysutils/docker-cli/Makefile
===================================================================
RCS file: /home/cvs/ports/sysutils/docker-cli/Makefile,v
diff -u -p -u -p -r1.16 Makefile
--- sysutils/docker-cli/Makefile 22 Oct 2024 19:08:51 -0000 1.16
+++ sysutils/docker-cli/Makefile 13 Dec 2024 19:47:55 -0000
@@ -1,6 +1,7 @@
COMMENT = command-line tool for controlling Docker

V = 27.3.1
+REVISION = 0
DIST_TUPLE = github docker cli v${V} .
PKGNAME = docker-${DISTNAME}

Index: sysutils/docker-cli/pkg/PLIST
===================================================================
RCS file: /home/cvs/ports/sysutils/docker-cli/pkg/PLIST,v
diff -u -p -u -p -r1.5 PLIST
--- sysutils/docker-cli/pkg/PLIST 11 Mar 2022 19:57:21 -0000 1.5
+++ sysutils/docker-cli/pkg/PLIST 13 Dec 2024 19:49:44 -0000
@@ -1,2 +1,3 @@
@conflict docker-*
@bin bin/docker
+share/doc/pkg-readmes/${PKGSTEM}
Index: sysutils/docker-cli/pkg/README
===================================================================
RCS file: sysutils/docker-cli/pkg/README
diff -N sysutils/docker-cli/pkg/README
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ sysutils/docker-cli/pkg/README 9 Nov 2024 09:07:10 -0000
@@ -0,0 +1,33 @@
++-------------------------------------------------------------------------------
+| Running ${PKGSTEM} on OpenBSD
++-------------------------------------------------------------------------------
+
+This is a command-line tool for controlling remote Docker.
+
+If you're looking for a local environment where you can use Docker in an
+expected way, you need to install and keep running some Linux inside
+vmd(8). Alpine is probably a good option because it contains not only
+the Docker package, but also virtio_vmmci-virt and vmm_clock-virt which
+improve integration with vmd(8).
+
+To access your Docker instance inside the VM, just add to your .profile:
+
+ DOCKER_HOST=ssh://10.36.25.37
+
+where 10.36.25.37 is the actual address of that VM.
+
+Additionally, if you wish to use the -v option to share your disk, you need
+to set up NFS sharing of some folders.
+
+For example, I have the following on the OpenBSD side in /etc/exports:
+
+ /home/USER/Projects /home/USER/src -mapall=USER -network=10.36.25 -mask=255.255.255.0
+
+and on the Alpine side you need to install nfs-utils package and put
+inside /etc/fstab:
+
+ 10.36.25.1:/home/USER/src /home/USER/src nfs _netdev 0 0
+ 10.36.25.1:/home/USER/Projects /home/USER/Projects nfs _netdev 0 0
+
+Finally, I suggest you read the OpenBSD FAQ's special sections about
+Virtualization and Networking.

--
wbr, Kirill