管理SourceForge项目的方法

管理SourceForge项目的方法

February 08, 2005

自己有一个好的idea，想要建立一个open-source的项目，
同时希望获得免费的主页空间、CVS服务、论坛、邮件列表等等……

最简单的方法，就是到SourceForge申请创建一个新的Project :)
当然，国内的gro.clinux.org也是相当相当不错的 至少教育网不用出国、速度快

以下是使用sourceforge的方法摘要，供自己备忘:)

• 当你的项目被批准时，会e-mail，含有项目相关的信息，例如：
  Project Descriptive Name: Software Engineering Environment
  Project Unix Name: thisproject
  CVS Server: cvs.sourceforge.net
  Shell Server: shell.sourceforge.net
  Web Server: thisproject.sourceforge.net
  
• 如果用windows平台的话，记得去下载一套TortoiseCVS，最好加上一套完整的putty(虽然TortoiseCVS含了)
  如何配置自己的帐号SSH key等等这里就不多说了
  
• 主页上传与管理
  项目主页的地址是："项目名.sourceforge.net" ，可以使用mysql和php。 
  应该记得在网页中加入sourceforge的图标和捐献的图标。
  
  putty套间里面有psftp.exe和putty.exe，ssh认证需要自己配置好。
  假设sourceforge用户帐号是"myaccount"，而项目名是“thisproject”，那么上传主页是这样操作的：
  1. 将你的所有文件打成一个zip包（或者tar包），例如是“myweb.zip”，将它放在psftp.exe所在的目录下。
  2. 执行psftp.exe
  3. 输入你的shell地址：“open myaccount@shell.sourceforge.net”，回车
  4. 输入你的帐号密码，回车。你将进入你的shell目录，即“/home/users/m/my/myaccount/”
  5. 进入你的网站目录，即：“cd /home/groups/t/th/thisproject/htdocs”
  6. 输入上传命令：“put myweb.zip” 
     （ 这是对静态页面而言，主页空间还有"cgi-bin"路径可用。）

       上传完毕后，就要用putty.exe来登陆到shell，用命令“unzip myweb.zip”解开zip包，putty使用步骤从略。

       此时，应该可以通过浏览器看到自己的主页 http://thisproject.sourceforge.net 了。

• 可以通过sourceforge来进行源码、可执文件等的release，sourceforge不限制使用这方面的空间。 

  sourceforge的上传机制是匿名的，所有用户共用一个上传目录，且不能删除已上传文件。
  如果在24小时内，文件没有被任何项目“认领”，则被自动删除。
  
  ftp地址是ftp://upload.sourceforge.net，匿名访问
  可以上传到“incoming”子目录内。
  
  上传后，进入自己项目的的sourceforge项目管理页面。
  
  点击项目管理页面上部的"Admin"，然后点击"File Releases"，则可进入文件发布系统
  添加release的时候，可以看到那个公共目录下当前所有未被“认领”的文件名，选择你自己刚上传的文件就可以了

• cvs的用法偶自己整理过了，bug相关的偶还不会，邮件列表很有用，不过对小项目似乎没啥意义 :)
  

• 如何配置Windows平台下的CVS系统

  CVS(并行版本系统)是在自由软件开发中用的最广泛的软件工程工具之一。
  
  它的方便、可靠、强大，在GNU/Linux相关的千千万万软件项目中已经得到了充分证明。
  
  这里主要是说说如何在Windows平台下为SourceForge类的服务平台配置CVS客户端。
  
  CVS客户端我们采用的是TortoiseCVS，这大概是Windows平台下最好用的一个了，与Explorer集成得十分完美。
  
  
  该软件详细的说明在这里有：
  http://www.redsaga.com/CVS_newbie_win32/TortoiseCVS.html
  这里就不赘述了
  
  关键是目前开放的CVS服务站点，大都采用SourceForge的源代码，很多都采用了SSH Key的形式来进行认证。
  
  例如 我在https://gro.clinux.org上建立了一个ucos-lwip-c6x项目
  
  那么我需要：
  
  1、生成一对Public Key 和 Private Key
  （最好通过 SSH命令行生成，例如在Cygwin里用"ssh -keygen -d"
  因为似乎GRO的服务器对于PuTTY软件包生成的key支持有问题。）
  
  2、进入https://gro.clinux.org的个人的"帐号维护"
  点击最下方的"CVS/SSH 共享认证Key:Edit Key"
  将生成的Public Key的内容粘贴进去，
  过大约6个小时以后守护进程会将新的Key载入服务。
  
  3、下载一个最新版本的PuTTY软件包（其实也就是一个Windows界面的SSH Client）
  运行其中的puttygen.exe，打开刚才生成的Private Key，
  将其另存为SSH2 DSA的格式（Cygwin生成的是Open SSH的）
  
  4、运行PuTTY包里面的Pageant（也可以放在自动启动中）
  用Add Key 把刚才另存的Private Key 加载进去
  （pageant的作用是运行在后台，在PuTTY的其它组件需要认证的时候自动提供Private Key）
  
  5、在Explorer单击右键，选择TortoiseCVS的Preference，做一些简单的设定
  
  
  
  
  6、剩下的操作就没有什么特殊的了
  需要注意的是，GRO的CVS服务器可能需要用项目的子域名 比如 cvs.ucos-lwip-c6x.gro.clinux.org