This part gives an introduction into the OpenCIT. It explains the idea behind the OpenCIt and its purpose.
The target audience of this part is everyone interested into the OpenCIT.
Like any open source project we have the problem that writing documentation is a pain and nobody is paid for doing it. In combination with the rapidly changing OpenCIT source base this will lead to a huge mess within shortest time. To avoid this problem we've introduced regular documentation reviews and, more importantly, the following rules which apply both for writing the document and for reading it.
The Open Continuous Integration and Test (OpenCIT) server can be used to automatically build, test and deploy projects. It makes it easier for developers to integrate changes and easier for users to obtain fresh builds of a project.
The OpenCIT tries to provide additional benefits compared to other CI & T solutions by building upon the open and highly customizable OpenEngSB platform. Furthermore the OpenCIT itself is also a FOSS project, which provides its users with the possibility to adapt all aspects of the CI & T process.
The domain and connector concept of the OpenEngSB make it possible to define the OpenCIT workflow completely independent of specific tools. Therefore any build, test and deploy tool can be used together with the OpenCIT.
This part gives an introduction into how to use the OpenCIT.
The target audience of this part are users of the OpenCIT.
To set up a basic OpenCIT setup follow these steps:
opencit/bin/karaf.sh serverto run the server. To be able to log off from the shell without terminating the server you can user
screen opencit/bin/karaf.shThere is also a start script for Microsoft Windows systems in opencit/bin/karaf.bat
Once OpenCIT is running use a webbrowser to open http://localhost:8095. Log in at the login screen with the (currently hardcoded) username "user" and password "password". After a successful login you will see a list of configured projects, which is empty in a freshly installed OpenCIT.
To set up a new project you have to configure 6 connectors:
For detailed information consult the next chapter.
This part gives an introduction into how to customize the OpenCIT.
The target audience of this part are developers, who want to customize the OpenCIT.
This part contains information for developers, who want to contribute to the OpenCIT project.
The target audience of this part are developers, who want to contribute to the OpenCIT project.
If you have a good idea for the improvement of the OpenCIT project, please feel free to contact us on the developer mailing list.
The guidelines for the development of the OpenCIT correspond to the guidelines for the development of the OpenEngSB. Therefore everyone who wants to contribute to the OpenCIT, should read the contribution section of the OpenEngSB manual.
The OpenCIT issue tracker can be used to file issue, bugs or other problems. Furthermore it is a great entry point for developers, who want to contribute, as they can browse the issues and find out in which direction the OpenCIT will develop in the future.
If there are any further questions about the development process for the OpenCIT, please feel free to contact the OpenCIT developer team through the mailing list.