Hi Emily,

Nick already laid it all out pretty well but just to add to it:
My suggestion would be to follow the instructions at koha-testing-docker https://gitlab.com/koha-community/koha-testing-docker which also include docker instructions links.
You will end up with 2 directories, one for k-t-d and one for the Koha code you're working with. This Koha code directory is mapped as a volume to the container when launched, so whatever changes to the code you make in this directory will reflect inside the container in real time (and vice-versa).

Another good place to ask questions and find valuable help is the community irc https://koha-community.org/get-involved/irc/



Pedro Amorim

Software Engineer

 

E: pedro.amorim@ptfs-europe.com

www.ptfs-europe.com






On Mon, 5 Dec 2022 at 15:23, Nick Clemens <nick@bywatersolutions.com> wrote:
1 - On Linux you do not need Docker Desktop - I have docker.io and docker-compose - I set this up long ago, so don't remember the steps, but you should not require a licence
2 - That is up to you. For editing code I think most developers use an IDE or something outside the docker container - I personally tend to work from within the container, but it is not necessary. Tests etc should be run in the container
3 - If you work inside the container then git-bz and all should be installed - it looks like work is being done to get the hools automatically installed (https://gitlab.com/koha-community/koha-misc4dev/-/issues/59) - if you work outside the container, then yes, installing git bz and  pre-commit hook should get you well started

On Mon, Dec 5, 2022 at 11:06 AM Lamancusa, Emily <Emily.Lamancusa@montgomerycountymd.gov> wrote:
Hello all,

I'm trying to set up a Koha Testing Docker on my local machine (running Pop!_OS 22.04). I haven't used Docker before, and I have a few questions about how to get it set up.

1. It looks like Linux users have the option to install the whole Docker Desktop VM, or install just Docker Engine, Docker CLI, and the Compose plugin. Do I need Docker Desktop to run KTD, or will the latter installation option work on its own? (Aside from not wanting to install a bunch of extra stuff that I don't need, I would also need to request that my library system purchase a license for Docker Desktop, so I want to check if that is actually necessary.)

2. Is the idea to do all of the code editing, git commands, etc, from inside the container shell? Or would all of that be done outside the container, and the container be used only to run code/tests?

3. From what I've read in the wiki/getting started resources, I need Docker, the KTD itself, git-bz, and the git hooks from https://wiki.koha-community.org/wiki/Tips_and_tricks#git_tips_and_tricks (other than the pre-commit hook that is currently broken?) And then there's a tutorial on creating and submitting patches here (https://gitlab.com/koha-community/koha-howto/blob/master/README.md) that I can run once I have the KTD working. Am I missing anything? Hopefully this will make more sense once I have everything installed and can actually start playing with it, but I'll admit I'm feeling a little overwhelmed right now.

Thank you so much to anyone who can give this newbie a little extra guidance on how to get started!

Emily Lamancusa (she/her)
IT Specialist III
Montgomery County Public Libraries
21 Maryland Ave, Suite 310
Rockville, MD 20850
(240) 777-0676



For more helpful Cybersecurity Resources, visit: https://www.montgomerycountymd.gov/cybersecurity
_______________________________________________
Koha-devel mailing list
Koha-devel@lists.koha-community.org
https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
website : https://www.koha-community.org/
git : https://git.koha-community.org/
bugs : https://bugs.koha-community.org/


--
Nick Clemens
ByWater Solutions
Phone: (888) 900-8944
Pronouns: (he/him/his)
Timezone: Eastern
Follow us:
   
_______________________________________________
Koha-devel mailing list
Koha-devel@lists.koha-community.org
https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
website : https://www.koha-community.org/
git : https://git.koha-community.org/
bugs : https://bugs.koha-community.org/