KLDP.net
|
FreeSoftware, OpenSource 프로젝트 호스팅 공간.
1. 개괄 ¶KLDPnet은 OpenSource, FreeSoftware 개발자들을 위한 프로젝트 호스팅 공간입니다. 누구나 자유롭게 사용할 수 있고, CVS(소스코드 관리), 메일링 리스트, 버그 트래킹, 게시판, 홈페이지 호스팅, 파일 릴리즈 등 개발 작업에 필요한 거의 모든 요소들을 웹상에서 간편하게 활용할 수 있습니다.
KLDP.net에서 제공되는 여러가지 기능들은 프로젝트 운영에 쉽게 적용하실 수 있습니다. 각 부분을 어떤 용도로 어떻게 사용할 것인가에 대해 개략적으로 알아봅시다.
주: KLDP.net에서 제공되는 기능들은 각 프로젝트 관리자의 설정에 따라 사용할 기능과 사용하지 않을 기능을 정의할 수 있습니다. 프로젝트 초기 단계에서는 되도록 커뮤니케이션 채널을 단순화, 집중화하여 새롭게 프로젝트에 참여하고자 하는 이들이 혼란을 느끼지 않도록 하는 것이 좋습니다.
2.1. 기본작업 ¶프로젝트를 운영하기 위해서는 KLDPNet에 사용자 등록을 해야 합니다. 사용자 등록을 하는데는 무료이며 제한은 없습니다. 이 메일 주소는 정확히 자신이 사용하는 것을 입력해야 합니다. 사용자 등록 및 프로젝트 운영에 꼭 필요합니다. 입력한 이 메일은 겉으로는 절대 드러나지 않습니다. Jabber 주소에 가짜 이메일 주소를 입력하면 겉으로는 Jabber 주소에 입력한 이 메일이 드러나게 됩니다.
2.1.1. 프로젝트 개설 ¶사용자 등록을 마친 후 로그인을 하면 개인 페이지가 먼저 화면에 표시됩니다. 개인 페이지에 프로젝트 등록하기메뉴를 통해서 프로젝트를 개설할 수 있습니다. 프로젝트 이름과 목적과 요약을 정확하게 입력합니다. 라이센스, 프로젝트 공개설명, 프로젝트 유닉스 이름을 입력합니다. 프로젝트 유닉스 이름은 나중에 example.kldp.net와 같이 프로젝트 홈페이지 및 CVS 도메인으로 사용됩니다.
프로젝트는 KLDPNet 관리자가 개설 승인을 내리면 개설되게 됩니다. 프로젝트 승인 여부는 KLDP.net 관리자가 결정하며 프로젝트가 승인되었는지 반려되었는지 그 결과가 이메일로 전송됩니다. 가끔 개인적인 사정으로 승인 작업이 지연될 수도 있으니 이해해 주시기 바랍니다.
2.1.2. 기본 정보 설정, 초기화 ¶프로젝트가 개설되면 기본 정보를 설정합니다. 프로젝트를 개설 신청한 ID로 로그인 한뒤에 프로젝트 페이지로 이동합니다. 개설 신청을 한 사람이 프로젝트 관리자가 됩니다. 프로젝트 관리자는 프로젝트 관리라는 메뉴를 사용 할 수 있습니다. 이 프로젝트 관리 메뉴에서 새 멤버를 추가하거나 여러가지 정보를 설정 할 수 있습니다.
소프트웨어 맵 분류를 설정합니다. 프로젝트에 알맞게 분류, 대상, 개발 상황, 라이센스, 사용 언어, 운영체제, 실행 환경등을 설정합니다. 이렇게 설정된 내용은 바로 반영되지 않습니다. crontab에 의해 하루 뒤에 반영되서 KLDPNet의 프로젝트 트리에 등록됩니다.
2.1.3. 파일 릴리즈 ¶프로젝트 관리 메뉴에 가시면 파일 릴리즈 편집이라는 메뉴가 있습니다. 여기서 일단 패키지를 먼저 생성합니다. 빈 칸에 원하는 패키지 이름을 입력하고 이 패키지를 생성합니다 버튼을 누르게 되면 패키지가 생성됩니다. 다음에는 각 패키지 별로 릴리즈 메뉴가 생기는데, 여기서 원하는 패키지의 릴리즈추가 라는 링크를 클릭하면 릴리즈를 추가할 수 있는 폼이 나오게 됩니다. 여기서 릴리즈 이름은 보통 릴리즈의 버젼 번호를 사용합니다. 파일은 이전과 같이 ftp를 사용해서 올리는 것이 아니고 브라우저에서 직접 파일을 올리게 되니까 주의하십시오. 그리고 소스 tarball을 올린다면 파일 형식으로 source .gz, .bz2 등을 선택하고 프로세서 타입도 적당한 것을 고릅니다. 보통 소스의 경우는 any를 많이 붙입니다(사실 다른 arch에서 컴파일되고 작동한다는 보장을 못하더라도 말이죠
.png ":)") 릴리즈 노트와 변동사항(ChangeLog)은 사용자들의 이목을 끌수 있는 말로 채우면 됩니다.
 릴리스 tarball 작성시 확인 할 것들 (AutoTools 를 사용하는 경우)
2.2. 공동작업 ¶대부분 프로젝트 활동은 소스 코딩과 버그 패치, 메일링 리스트, 게시판 활동, 소스 릴리즈등입니다. 프로젝트 관리자가 멤버를 추가하여 공동 작업을 하게 됩니다. 소스 코딩의 경우 CVS를 이용해서 공동작업을 하게 됩니다. CVS에 관한 내용은 아래 소스 관리 부분을 참조해 주시기 바랍니다.
2.2.1. 프로젝트 홍보 ¶자유 소프트웨어/오픈소스 소프트웨어 개발의 가장 큰 즐거움들 중 하나는 많은 사람들과의 커뮤니케이션을 통한 상호 작용입니다. 이를 위해서는 우선 프로젝트의 존재를 적극적으로 알릴 필요가 있습니다.
그러기 위해서 가장 중요한 것은 프로젝트 홈페이지의 구성입니다. 초라한 페이지라도 아무것도 없는 것보다는 훨씬 낫습니다. 기본적인 프로젝트 소개와 KLDP.net 페이지로의 링크 정도만으로도 충분합니다. 홈페이지를 개설하기가 번거롭다면 KLDPWiki를 간단히 이용할 수도 있습니다.
그 다음으로 프로젝트 홍보를 위해 중점적으로 관리해야 할 항목은 최신 소식란입니다. 각각의 프로젝트 페이지 오른쪽 절반 정도를 차지하고 있는 최신 소식란은 프로젝트 관리자가 알리고 싶은 내용을 자유롭게 올릴 수 있는데 이곳에 글을 올리게 되면 그 글이 자동으로 KLDPNet 관리자에게도 재전송되므로 KLDPNet 관리자는 그 글을 KLDPNet 초기화면에 올릴 것인지를 결정할 수 있으며 초기화면에 글을 올려 달라고 별도로 신청할 필요가 없습니다. 따라서 새소식을 올릴 때는 최대한 자세하게 작성해야 그 글이 KLDPNet 초기화면에 올라오더라도 읽는 사람들이 쉽게 이해할 수 있습니다.
KLDPNet 초기화면에 게시되는 소식들은 KLDP에서도 항시 생중계되므로 좀더 많은 사람들에게 쉽게 전파될 수 있습니다. KLDPNet 초기화면의 소식들은 RDF/RSS를 사용하므로 누구든 중계할 수 있습니다. (http://kldp.net/export/rss_sfnews.php)
그 외 프로젝트 페이지를 각 검색엔진 사이트나 다른 관련 사이트, 뉴스그룹 등에 적절한 방법으로 홍보하는 것도 당연히 신경써야 할 부분입니다.
2.2.1.1. 홈페이지 등록 ¶KLDP.net에 홈페이지를 올리시려면 scp를 이용하셔야 합니다. 보안상의 문제로 직접 쉘로 로그인은 불가능하며 오직 파일을 올리는 것만 가능합니다. 프로젝트 이름이 xxxproject이고 사용자 이름이 id라고 가정하면 다음과 같은 방법으로 파일을 올리면 됩니다.
$ scp index.html id@xxxproject.kldp.net:/var/lib/gforge/chroot/home/groups/xxxproject/htdocs id@xxxproject.kldp.net's password: index.html 100% |*****************************| 173 00:00 $ 2.3. 소스관리 ¶xxxproject라는 프로젝트가 있다고 가정합시다. 프로그램의 이름은 hello-world라고 가정합니다. 그러면 xxxproject 프로젝트의 CVS에 hello-world의 소스코드를 올려야 합니다. (CVS에서 사용하는 용어로 말하자면 import한다고 합니다.) 방법은 다음과 같습니다.
# cd hello-world hello-world# export CVS_RSH=ssh hello-world# cvs -z3 -d:ext:id@cvs.foo.kldp.net:/cvsroot/xxxproject import -m 'Import' hello-world vendor start 여기서 id, xxxproject, hello-world는 각자 상황에 맞게 바꾸어 주면 되고 Import, vendor, start도 마찬가지로 바꾸어 줍니다. 기본적으로는 id, xxxproject, hello-world 부분만 주의해서 써 주면 되고, 위의 예제에서 볼 수 있듯이 import 명령은 반드시 해당 소스코드(위의 예에서는 hello-world)가 있는 디렉토리로 이동해서 수행해야 한다는 사실을 명심하십시오.
해당 프로젝트에 적절한 권한이 없으면 프로젝트 CVS 트리에 소스코드를 import할 수 없으니 반드시 프로젝트 관리자, 혹은 프로젝트에 개발자로 등록되어 있는 사람만이 위의 명령을 수행할 수 있다는 사실에 주의하십시오.
일반 사용자는 해당 프로젝트 요약 페이지에 있는 CVS 페이지를 참고하시면 소스를 열람하실 수 있고, 소스를 내려받으실 수도 있습니다.
추가팁: 만약 익명로그인 사용자이고 익명사용자 계정이 암호가 필요없는 공백인경우에 다음과 같이 하면 추가적인 "Enter"입력없이 명령이 실행될수 있습니다. 즉, ID 뒤에 콜론(":")을 삽입하면 됩니다. 당연히 암호가 있을경우 그 콜론(":")의 뒤에 암호를 입력해 놓으면 한번에 실행할수 있습니다. 결국 Shell script에 이러한 응용을 하면 암호입력 과정이 생략된다는 것이죠.
# cd hello-world hello-world# export CVS_RSH=ssh hello-world# cvs -z3 -d:ext:anonymous@cvs.foo.kldp.net:/cvsroot/foo import -m 'Import' hello-world vendor start See also: KLDPNetCVS-HOWTO CVS
3.1. 기본적인 자세 ¶KLDP.net에 서 운영되고 있는 여러 프로젝트들을 찾아보기 위해서는 우선 초기화면의 여러 새소식들을 살펴보거나 왼쪽 네비게이션 바 가운데쯤에 있는 소프트웨어 맵을 살펴 보시면 됩니다. 만약 프로젝트 운영자라면 자신의 프로젝트를 소프트웨어 맵에 등록하지 않을 경우 KLDP.net 이용자들이 해당 프로젝트의 존재 여부를 알 수 있는 방법이 없어지므로 사이트 문서를 참고하여 꼭 프로젝트를 소프트웨어 맵에 등록해 주셔야 합니다.
프로젝트에 참여하는 것은 거창하게 생각할 필요가 전혀 없으며, 기본적으로 해당 프로젝트에서 릴리즈한 소스가 있다면 그것을 내려받아서 실행해 보고 문제점을 알려 주거나, 개선 사항을 이야기해 주거나, 원하는 기능 등을 프로젝트 페이지의 적절한 부분에 올리면 됩니다. 프로젝트 운영자 및 개발자들은 사용자 여러분의 피드백을 기다리고 있습니다. 프로젝트에 참여하고자 한다는 마음만 가지고 있어서는 아무런 소용이 없습니다. 실제로 눈에 보이는 활동이 보이지 않는 마음보다 훨씬 중요합니다. 프로그래밍을 잘 하지 못한다 하더라도 테스터로서의 역할이나 일반 사용자로서 원하는 개선사항 등에 대한 의견을 내는 것은 누구나 할 수 있는 일입니다. 적극적이면서도 예의바른 의견교환이야말로 개발자가 즐겁게 프로젝트를 이끌어 나갈 수 있는 가장 큰 원동력입니다.
만약 소스코드 수정 작업 자체에 참여하고자 한다면 사이트 문서를 참고하여 CVS 및 패치 파일을 다루는 방법을 먼저 익혀 두는 것이 편리합니다. CVS를 굳이 모르더라도 프로그래밍 작업 자체에는 문제가 없겠지만 개발자의 수가 늘어나고 서로 작업하는 부분이 명확히 구분되지 않을 경우는 소스가 꼬일 확률이 크니 CVS 사용법을 잠깐동안만이라도 시간을 내서 익힌 다음 사용하는 것이 효과적입니다. 물론 CVS도 개발 작업을 도와주기 위한 툴의 하나일 뿐이며 가장 중요한 것은 무엇보다도 참여하고자 하는 마음입니다.
3.3. 패치 제출 ¶CVS를 통해서 작업을 할 경우 수정 사항을 개발자에게 보낼 때 패치를 활용하면 아주 편리하게 작업할 수 있습니다. 예를 들어 foo라는 프로젝트의 소스코드를 CVS를 통해 다운로드하여 프로그램을 빌드하였는데 사용해 보니 코드에 명백한 버그가 있어 코드를 수정하여 버그를 해결했다고 가정합시다. 그럴 경우 수정한 코드를 원 개발자에게 보내 주어 원래의 소스코드에 변경된 내용이 적용되어야 할 것입니다.
이렇게 원래의 소스코드와 변경된 소스코드의 차이점에 대한 정보만을 담고 있는 파일을 패치파일이라 하며 CVS를 사용할 경우 다음과 같은 방법으로 매우 쉽게 패치파일을 만들 수 있습니다.
우선 현재 가지고 있는 CVS 소스트리를 최신 버전으로 업데이트합니다. 이것은 만약 내가 소스를 변경하고 있는 도중에 다른 개발자가 같은 부분을 변경하여 CVS 소스트리에 변경사항을 이미 적용해 버렸을 경우 충돌이 일어날 확률을 최소화하기 위한 것입니다.
cvs update
이제 패치 파일을 만듭니다.
cvs diff > foobar.patch
이렇게 만들어진 패치 파일을 각 프로젝트의 패치 관리자에 등록하거나 혹은 프로젝트 개발자에게 직접 보내주면 됩니다.
diff와 patch에 대한 더욱 자세한 설명은 DiffAndPatch 페이지를 참조해 주십시오.
이 문서에서는 CVS를 통한 개발작업시 패치 파일을 만드는 방법에 대해서만 간단하게 설명하고 있으므로 CVS의 실질적인 활용에 대한 좀더 자세한 정보는 CVS를 참고하십시오.
4. KLDPnet에 관한 질문과 답변 ¶Q: 비밀번호를 잊어버렸습니다. 어떻게 하죠?
A: 로그인 페이지 아랫 부분에 보시면 비밀번호를 이메일로 받아보실 수 있는 기능이 있습니다.
Q: 이 사이트의 소스코드를 얻을 수 있나요?
A: 가능합니다. GForge 페이지를 참고하세요.
Q: 이 사이트의 관리자와 연락하고 싶은데요.
A: 관리자 권한으로 해야 하는 일이 있다면 http://kldp.net/projects/siteadmin/에서 SupportRequests에 필요한 요청을 하면 됩니다.
Q: 이곳에 있는 프로젝트들을 찾으려면?
A: 왼쪽 네비게이션 바 아랫부분의 "소프트웨어 맵"을 참고하세요.
Q: 프로젝트 등록 신청을 했는데 승인이 안나는군요.
A: 프로젝트 승인 여부는 KLDP.net 관리자가 결정하며 프로젝트가 승인되었는지 반려되었는지 그 결과가 이메일로 전송됩니다. 혹시 개인적인 사정으로 승인 작업이 지연될 수도 있으니 이해해 주시기 바랍니다.
Q: 프로젝트가 거부되는 경우도 있나요?
A: 있습니다. 예를 들면 라이센스가 OpenSource 혹은 FreeSoftware 에 위배될 경우(독점적 라이센스)에는 프로젝트를 등록하실 수 없습니다.
Q: 이곳은 주로 어떤 프로젝트를 위한 공간인가요?
A: 이곳은 기본적으로 소프트웨어 개발에 적합한 곳입니다. 버그 트래킹, 기술지원 및 패치 관리 등을 통해 다른 개발자들과의 협력 아래 소프트웨어를 버전업하는데 적절한 구조를 갖추고 있습니다. 꼭 소프트웨어만이 아니더라도 사이트에서 제공하는 여러가지 기능들이 운영하시고자 하는 프로젝트에 효과적으로 활용 가능하다고 판단되시면 프로젝트를 신청하실 수 있습니다.
Q: 소프트웨어 맵에 프로젝트를 등록했는데 적용이 안됩니다.
A: 소프트웨어 맵은 실시간으로 업데이트되는 것이 아니라 crontab에 의해 하루에 한번씩 갱신되므로 하루 정도 기다렸다가 확인해 보세요.
Q: 프로젝트 운영시 일부 기능만 사용하고 싶은데요.
A: 왼쪽 네비게이션 바 아랫 부분의 프로젝트 관리 - Edit Public Info를 이용하시면 사용하고 싶은 기능만을 선별할 수 있습니다.
Q: 초기화면에 제 프로젝트에 대한 뉴스가 나오게 하려면 어떻게 하나요?
A: 운영하고 계신 프로젝트에 새소식을 올리면 그것이 바로 KLDP.net 관리자에게 자동으로 재전송되며 관리자는 그 새소식을 초기화면에 등록할지 여부를 선택할 수 있으므로 별도로 신청을 할 필요는 없습니다. 본인이 올린 뉴스가 초기화면에 올라갈 수 있도록 하기 위한 확률(?)을 높이기 위해서는 뉴스 작성시 반드시 표준어를 사용해 주시고 내용을 최대한 자세하게 구성해 주시면 더욱 좋습니다. 특히, 통신어체의 사용은 자제해 주십시오.
Q: SSH로 CVS에 접근할 때 매번 비밀번호를 입력하는 것이 번거롭습니다.
A: 자신이 개발자로 등록되어 있는 프로젝트의 CVS 사용시에 매번 비밀번호를 입력하지 않도록 하려면 다음 명령으로 ~/.ssh/id_rsa 와 ~/.ssh/id_rsa.pub 파일을 생성합니다.
$ ssh-keygen -t rsa
pass phrase를 물어볼 때 그냥 ENTER. 그렇지 않으면 나중에 이 pass phrase를 계속 물어보게 되므로 keygen하는 의미가 없어집니다.
KLDPNet에 로그인한 후 '사용자 등록 정보' 페이지로 가면 제일 밑 부분에 CVS/SSH Shared Keys를 입력하는 부분이 있으며, 그 곳에 id_rsa.pub 파일의 내용을 복사해 넣으면 됩니다.
중요한 사실은 반드시 전체 내용이 한줄로 입력되어야 한다는 것입니다. id_rsa.pub 내용 그대로 줄바꿈 없이 복사해 넣으셔야 합니다.
키 동기화는 crontab으로 정해진 시간에만 이루어지므로 실제 사용은 곧바로 하실 수 없고, 최대 1시간 이후에 사용하실 수 있습니다. 참고하세요.
Q: 개인의 일기와 메모를 지우려면 어떻게 하죠?
A:
Q: kldp.net 비밀번호는 기억하고 있는데 GNU mailman 비밀번호를 분실했습니다. 비밀번호를 이메일로 전송하기를 눌러도 오지 않는데 방법이 없을까요? 메일링 리스트 스팸을 처리해야 하는데요.
A: 관리자 권한으로 해야 하는 일이 있다면 http://kldp.net/projects/siteadmin/에서 SupportRequests에 mailman 비밀번호 분실이라는 내용을 포함해서 올려주시면 이메일로 알려드립니다.(관리자의 수동처리를 요하는 작업이라 즉각응답이 없을 수도 있습니다.)
Q: 관리자가 저 하나였는데 개발자로 저를 지정했더니 프로젝트 관리가 안됩니다. 관리자 권한을 잃어서 이런 것 같은데요, 어떻게 살릴 방법 없을까요?
A: 프로젝트 관리자는 자동으로 개발자의 권한을 부여받으므로 그렇게 하시면 해당 프로젝트의 관리자 권한을 스스로 버리는 것이 되므로 그렇게 하시면 안됩니다. KLDPNet 사이트 관리자에게 권한을 복구시켜 달라고 하셔야 합니다.
Q: 프로젝트의 홈페이지 공간에 파일을 올리려고 winscp 로 접속했더니 "Your shell is propably incompatible with the application." 라는 오류가 나며 접속이 안됩니다. winscp 로는 접속할 수 없는 건가요???
A:
Q: 이슈 작성일이 월일만 나오는데 년월일이 나오게 할 수 없는지?
|
Nobody expects the Spanish Inquisition!    
|
