Setting up Koha Testing Docker
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 [https://www.montgomerycountymd.gov/mcg/Resources/Images/Cybersecurity-footer...] For more helpful Cybersecurity Resources, visit: https://www.montgomerycountymd.gov/cybersecurity
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 <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 bywatersolutions.com Phone: (888) 900-8944 Pronouns: (he/him/his) Timezone: Eastern Follow us: <https://www.facebook.com/ByWaterSolutions/> <https://www.instagram.com/bywatersolutions/> <https://www.youtube.com/user/bywatersolutions> <https://twitter.com/ByWaterSolution>
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 <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 bywatersolutions.com Phone: (888) 900-8944 Pronouns: (he/him/his) Timezone: Eastern Follow us: <https://www.facebook.com/ByWaterSolutions/> <https://www.instagram.com/bywatersolutions/> <https://www.youtube.com/user/bywatersolutions> <https://twitter.com/ByWaterSolution> _______________________________________________ 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/
participants (3)
-
Amorim, Pedro -
Lamancusa, Emily -
Nick Clemens