Projects:Guide to create projects

aus eecoo wiki, der freien Wissensdatenbank

In this section you'll get some little instructions for creating new projects on rose, the eecoo server.

Inhaltsverzeichnis

[bearbeiten]

System requirements

For more information see the current setup on [http://eecoo.net rose] (last update brainbug 13:28, 13 Mai 2006 (CEST)):

[bearbeiten]

Initiating a new Project

First of all choose some (eecoo wide) unique name for the new project and decide wheather it is a standalone project or if it is a subproject of another (existing or non-existing) project, although this devision is not covered more precisely in this article.

Currently there are four different parts of the eecoo network where your project can appear:

You can simply use the shell script 'createProject' located in /home/webhost/bin to create a new project: 

/home/webhost/bin/createProject yourProject

Or do it manually as follows:

[bearbeiten]

Step 1: Creating an SVN Repository

The most common task to perform if you start a new project is to create a subversion repository. To do this follow the steps below:

Note: please create a new repository for each project. The model of storing more projects in the same repository using different root folders is now deprecated. This procedure is highlighly recommended for future compatibility and applicability reasons.

  1. Login as webhost on eecoo.net via your preffered SSH client (i.e. PuTTy)
  2. switch to the repository base directory located in the svn subdomains base path:
    cd /home/webhost/domains/eecoo.net/svn/SVN
  3. create the new repository:
    svnadmin create yourProject
  4. Ensure Apache's group www-data can access the newly created repository:
    chmod -R g+rw yourProject

That's it. Now you have installed a new repository that is accessible via your browser by locating http://svn.eecoo.net/yourProject or any webdav enabled client such as the Eclipse Subversion Client.

Your repository is per default simply secured (via HTTP Auth Basic, which is not really secure!) with the common eecoo network realm and user/password data. This will be extended in the future so that you can define your own authentication rules and we'll install at least digest authentication (at best using an ldap enabled database).

Please follow now the instructions for initially commiting a repository using our recommended repository layout.


[bearbeiten]

Step 2: Enable your project to be managed via Trac

With Trac you can setup your own wiki and issue tracking system as well as viewing the change log of your repository. Creating a Trac instance for your project is recommended if the project is planned to last over a longer term or if more than one developers participate.

Because every Trac managed project is bound to exactly one svn repository ensure that your repository is up and running before starting the steps below.

  1. Again, login as webhost on eecoo.net via your preffered SSH client (i.e. PuTTy)
  2. switch to the projects subdomains base directory:
    cd /home/webhost/domains/eecoo.net/projects/ROOT
  3. create the new project:
    trac-admin yourProject initenv yourProject sqlite:db/trac.db /home/webhost/domains/eecoo.net/svn/SVN/yourProject /usr/share/trac/templates
  4. Once again, ensure Apache's group www-data can access the newly created repository:
    chmod -R g+rw yourProject

So we're done with trac so far. You can now access the wiki and issue tracking system via http://projects.eecoo.net/yourProject.


[bearbeiten]

Step 3: Announce the project on the wiki pages

The main project description should remain in the wiki of your project (which is included in our currently installed project management tool trac). But in order to keep the eecoo wiki's project page up-to-date you should at least copy a link to the newly created project and a one-liner on the projects overview site.

Von "http://wiki.eecoo.net/index.php/Projects:Guide_to_create_projects"