[Koha-devel] Setting up Koha Testing Docker

[Amorim, Pedro]

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 at ptfs-europe.com

www.ptfs-europe.com





On Mon, 5 Dec 2022 at 15:23, Nick Clemens <nick at 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 at 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 at 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 at 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/
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.koha-community.org/pipermail/koha-devel/attachments/20221205/f422c53d/attachment.htm>