자카르타 Commons 프로젝트는 독립적으로 릴리즈되는 패키들을 보완하는 역할을 하기 때문에 다른 많은 자카르타 프로젝트와는 다르다. 그러므로 개별적인 패키지의 릴리즈 과정이 문서화 될 필요가 있다. 이는 패키지 작가들이 일관된 관례을 따르도록 할 것이다.

개별적인 패키지들은(Cactus 같은) 이들의 관례가 방대하다. 이는 그들이 전형적인 Commons 패키지보다 다소 크기 때문이다. 그러나 이들의 단계들은 방대한 케이스들을 대하여 충분함을 증명해야 한다.

다음 단계들이 Commons라이브러리 패키지들의 배포버전을 만들고 설치하는데 요구되어 진다. 예제 텍스트는 우리가 임의의 foo 패키지에 대하여 버전 1.2를 릴리즈하고 있다고 일관되게 가정한다.

For components other than Collections:

1. commons-dev@jakarta.apache.org 메일링 리스트에 특별한 패키지에 대한 당신의 제안 릴리즈를 공표하라. 그리고 투표를 요청하라. Commons 프로젝트 헌장에 따라, 의문속의 특별한 패키지들에 대한 커미터들의 투표들이(STATUS.html에 리스트 될 때) 구속력이 있다.
   
   
2. jakarta.apache.org (via SSH)에 로그온하고 당신이 생성하고자하는 릴리즈를 위한 새로운 서브디렉토리를 만들어라. 예를 들어;

   cd /www/jakarta.apache.org/builds/jakarta-commons/release/commons-foo/
   mkdir v1.2
   

3. 체크아웃하고 당신이 릴리즈하려고 계획하는 패키지 코드를 전체적으로 테스트하라.
   
   
4. 그 프로젝트를 위한 build.xml의 프로젝트 버전번호를 업데이트하라. 만약 foo 프로젝트가 일반적인 build.xml규약을 따른다면, component.version이라고 이름지어진 Ant속성이 있을 것이다. 이 속성이 1.2로 되어야 한다. 당신이 수정한 화일이 어느 것인지를 체크하라.
   
   
5. 단지 그 패키지의 서브디렉토리안에 화일들에만 당신이 생성한 패키지의 버전번호와 이름(첫글자는 대문자로)을 붙여라. 예를 들어;

   cd $JAKARTA_COMMONS_HOME/foo
   cvs tag FOO_1_2
   

6. dist 타켓을 실행하여 코드의 바이너리 배포본을 재생성하라. 생성된 문서를 재검토하여 이것이 코드의 기능성(과 버전번호)을 올바르게 반영했는지를 확실히 해라.
   
   
7. 이전 단계에서 만들어진 dist서브디렉토리의 내용에 기반하여, 이 릴리즈의 바이너리 배포본을 만들어라. 예를 들어,

   cd $JAKARTA_COMMONS_HOME/foo
   mv dist commons-foo-1.2
   tar zcvf commons-foo-1.2.tar.gz commons-foo-1.2
   zip -r commons-foo-1.2.zip commons-foo-1.2
   mv commons-foo-1.2 dist
   

8. 바이너리 배포 화일들을 새롭게 만들어진 디렉토리에 업로드하라(Upload the binary distribution files to the newly created directory on daedalus). 예를 들어 ("xyz"이 당신의 로그인이라고 하면),

   cd $JAKARTA_COMMONS_HOME/foo
   scp commons-foo-1.2.* \
    xyz@jakarta.apache.org:/www/jakarta.apache.org/builds/jakarta-commons/release/commons-foo/v1.2/
   

9. cvs.apache.org에 로그인하고 이전에 만들어진 태그에 기반하여 소스배포본들을 만들어라. 그리고 이들 화일들을 배포디렉토리에로 잘 옮겨라. 예를 들어 ("xyz"이 당신의 로그인이라고 하면),

   mkdir temp
   cd temp
   cvs -d /home/cvspublic export -r FOO_1_2 jakarta-commons
   mv jakarta-commons commons-foo-1.2-src
   tar zcvf commons-foo-1.2-src.tar.gz commons-foo-1.2-src
   zip -r commons-foo-1.2-src.zip commons-foo-1.2-src
   rm -rf commons-foo-1.2-src
   scp commons-foo-1.2-src.* \
     xyz@jakarta.apache.org:/www/jakarta.apache.org/builds/jakarta-commons/release/commons-foo/v1.2/
   

10. 자카르타 웹사이트를 업데이트하기 위하여 포준 과정들을 따라라.( 새로운 릴리즈의 유용성을 반영하기 위하여 CVS저장소의 jakarta-site2에 저장되어 있다. 일반적으로 당신은 다음 페이지들을 업데이트할 것이다;
    • xdocs/site/binindex.xml - Release Builds 헤딩 아래에 릴리즈 디렉토리 링크를 만들어라.
    • xdocs/site/sourceindex.xml - Release Builds 헤딩 아래에 릴리즈 디렉토리 링크를 만들어라.
    • xdocs/site/news.xml - 새로운 릴리즈를 기술하는 뉴스 아이템을 만들고 릴리즈 디렉토리에 하이퍼링크를 포함시켜라.
    
    
    
11. (최소한) 다음의 메일링 리스트들에 새로운 패키지의 유용함을 공표하라:
    • announcements@jakarta.apache.org
    • general@jakarta.apache.org
    • commons-dev@jakarta.apache.org
    
    
    

For Collections:

1. 위의 스텝의 1-5 를 따라 행하라
2. "cvs.tag"속성이 올바르게 셋팅되었는지 확인하기 위하여 build.xml화일을 재검하라. 예를 들어,

   <property name="cvs.tag" value="FOO_1_2"/>

3. "cvs.root"속성이 올바르게 셋팅되었는지 확인하기 위하여 build.properties 화일을 재검하라. 예를 들어,

   ## in build.properties where "xyz" is your login
   cvs.root=:pserver:xyz@localhost:/home/cvs
   

4. 컴퍼넌트 디렉토리에서, ant clean dist dist-src 를 실행하라.
5. 바이너리 배포 화일들을 새롭게 만들어진 디렉토리에 업로드하라(Upload the binary distribution files to the newly created directory on daedalus). 예를 들어 ("xyz"이 당신의 로그인이라고 하면),

   cd $JAKARTA_COMMONS_HOME/foo/dist
   scp commons-foo-1.2* \
    xyz@jakarta.apache.org:/www/jakarta.apache.org/builds/jakarta-commons/release/commons-foo/v1.2/
   

6. daedalus에 릴리즈 노트를 복사하라. ("xyz"이 당신의 로그인이라고 하면),

   cd $JAKARTA_COMMONS_HOME/foo/dist
   scp RELEASE-NOTES-1.2.html \
    xyz@jakarta.apache.org:/www/jakarta.apache.org/builds/jakarta-commons/release/commons-foo/v1.2/
   

7. components.xml 과 collections.xml (STATUS.html에 대한 링크를 포함하여) 화일들을 업데이트하라. jakarta-commons 모듈의 루트에서 ant 명령을 실행하라. docs 디렉토리에 이 문서의 HTML버전들이 만들어질 것이다. 생성된 docs를 체크하라.
8. Collections 빌드로부터 API docs들을 CVS안의 jakarta-commons/docs/collections/api 디렉토리로 복사하라. 영구적으로 삭제된 어떠한 컬렉션에 대한 javadoc들이 제거 되었는지를 확인하라.
9. jakarta.apache.org상에 로그인하고 사이트의 새로운 문서를 이용하기 위하여 CVS 업데이트를 수행하라.:

   cd /www/jakarta.apache.org/commons/
   cvs update
   

10. 위의 스템 중 10-11 따라라.