美文网首页Git
码云SVN支持

码云SVN支持

作者: NeWolf | 来源:发表于2017-02-18 20:23 被阅读294次

    现在码云目前支持使用 Subversion 对仓库进行操作,以下是使用指南和注意事项。

    使用前注意

    仓库体积超过300 MB不建议使用 Subversion 操作仓库,存储库容量达到 400 MB,或者 300 MB 并且存储大量非文本数据时,我们将关闭仓库的 Subversion 支持。

    由于 GIT 不支持空目录的提交,在存储机器上,无论是普通仓库还是开启 Subversion 接入的仓库存储时都是 GIT 仓库,Subversion 的 commit 是提交到 git 仓库上的,所以码云的 Subversion不支持空目录的提交。

    第一次开启 Subversion, 操作一个仓库,如果仓库体积较大或者提交次数较多,由于缓存的缘故,响应时间会比较长。

    不支持 Subversion 的 Hook 机制,请使用 WebHook 替代。

    Subversion 属性不完全支持。

    客户端需要开启 SASL 支持,不支持的客户端无法访问。

    部分 svn 命令不支持。可以查看Subversion 客户端的兼容性

    版本号的映射,目前 Subversion 的版本号计算依据为本分支所有的commit 数目减一 不包括 merge ,如果使用了在 git 中强制回退等操作,请重新检出。

    WARNING:

    由于 git 在设计上就没有考虑空文件Kernel.org: Git FAQ

    我们设计的原则就是不破坏,不主动修改用户的仓库,我们的后端存储的完全是一个 git 仓库,如果我们添加了,一次提交内容也不会一致了,建议你在添加目录的时候添加 .keep 之类的占位文件,空文件即可。

    Git 与 SVN 混用时尽量不要使用 Git 强制推送。Git 与 SVN 混用注意事项

    关于改版

    Subversion 功能的最终解释权归 OSChina.NET 所有。Subversion 接入的规则可能在下一次改版中发生改变。

    开启方式

    在项目的设置界面开启

    如果是空仓库:

    使用指南

    码云 支持的是 svn 协议。  对于 svn 而言,获取一个仓库的代码通常是 checkout,在项目主页我们通常可以获得 URL:

    这个仓库地址为:

    svn://git.oschina.net/svnserver/newos

    1.获取仓库代码:

    svn checkout svn://git.oschina.net/svnserver/newos newos

    注意信息码云的 SVN 接入后端是通过 git 存储库实现,URL 规则为 svn://域名/用户名/项目名 .

    使用上述命令,我们将得到项目默认分支的代码。并将本地的工作目录命名为newos

    如果最后不带 newos,svn 默认把本地工作目录命名为 项目名

    svn checkout svn://git.oschina.net/svnserver/newos

    如果要获得任意分支代码,例如获取newos的dev分支,请输入近似如下的命令:

    此时地址为:svn://域名/用户名/项目名/branches/分支名.

    svn checkoutsvn://git.oschina.net/svnserver/newos/branches/dev

    特别的说明,获取主干分支,也就是 master 分支可以使用下面的分支格式

    svn checkoutsvn://git.oschina.net/svnserver/newos/trunknewos

    svn trunk 分支对应 master 分支 用户应当尽量不使用下面格式

    svn checkout svn://git.oschina.net/svnserver/newos

    操作说明

    如果部分检出仓库,并且仓库根目录下包含 branches/tags/trunk 这样的目录,请使用完整的路径 layout,如下:

    svn://git.oschina.net/username/example/trunk/tags/hellosvn://git.oschina.net/username/example/branches/dev/trunksvn://git.oschina.net/username/example/branches/dev/branches

    如果没有 master 分支,也就没有 trunk 分支,检出的 URL 不能省略分支名。比如只有一个 dev 分支,必须使用下列格式,否则会提示仓库不存在。

    svn cosvn://git.oschina.net/svnserver/newos/branches/dev  svnserver_dev

    打开终端,输入上述命令,出现以下下面提示。其中第一个认证领域是用户的密码,这个可以留空。而用户名是用户在 GIT@OSC 登陆时使用邮箱地址。密码则是用户登陆 码云 所使用的密码一般而言,svn 会加密缓存用户的用户名密码,所以,对仓库的操作只需要第一次输入用户邮箱和密码。清除密码缓存,用户目录下的.subversion/auth/svn.simple文件夹下的文件。

    下图则是成功的拉取了项目代码。

    查看本地工作目录信息:

    svninfo

    cdhelloworldecho"test"> SVNReadMe.md#svn add SVNReadMe.md#svn add * --force类似于git add -Asvn add * --forcesvn update .svn commit -m"first svn commit"

    Subversion 在提交前建议先使用 svn update 更新工作拷贝。也就相当于 git pull 后再 git push。

    Subversion 的提交是在线的,如果机器已经离线,那么提交会失败,这个过程用git的方式理解就是 git commit+git push。

    用户使用 svn 提交代码同样会有动态显示。

    列出版本库中的目录内容:

    svn listsvn://git.net/svnserver/newos/trunk

    导出仓库指定分支的所有文件,不含版本控制信息:

    svn exportsvn://git.net/svnserver/newos/trunknewos

    备注

    安装 Subversion 客户端

    在 Apache 基金会的 Subversion 官网:

    http://subversion.apache.org二进制下载提示页面:

    http://subversion.apache.org/packages.html

    Windows 系统:

    与资源管理起集成的 SVN 客户端:TortoiseSVN,通常被叫做"海龟",为 msi 安装包。可以使用ExtractMSI解压缩。很诡异的是,在 Apache 上并没有推荐 TortoiseSVN。另外还有 SlikSVN,下载地址:https://sliksvn.com/download/其他的也就不一一介绍了。

    Linux 系统

    一般而言 Linux 系统自带的包控制软件能够安装 Subversion,如果版本低于1.8,就建议用户下载预编译的二进制或者自己动手编译 Subversion。这里不做过多说明。

    OS X

    XCode 自带的 Subversion 版本为1.7.x,太老,而 GIT@OSC 只支持1.8以上的 SVN 客户端。

    如果安装了 Homebrew

    brew install subversion

    或者使用WANdisco的预编译版本http://www.wandisco.com/subversion/download#osx

    Subversion 客户端的兼容性

    我们支持 Apache Subversion 1.8 或者更高的版本,当你安装一个 Subversion 客户端时,如果错误提示是“无法协商验证验证方式” 请确保你的客户端支持 SASL 验证,比如在 Ubuntu 上,你可以安装 libsasl2-dev 然后编译 Subversion, 这样的话客户端是支持 SASL 验证的。

    sudo apt-get install libsasl2-dev

    当你使用 svnkit 或者 SubversionJavaHl 这类 IDE 集成客户端,请确保支持 SASL 验证。

    关于 GIT 与 SVN 的转换

    如果用户存在一个基于 Subversion 托管的项目,要迁移到 GIT@OSC,可以使用 git-svn 将项目转变为基于 git 的仓库,然后推送到 GIT@OSC,这样你依然能够使用SVN对项目进行操作。请记得先在 GIT@OSC 上新建一个项目

    git svnclonehttp://myhost/repo -T trunk -b branches -t tagsgit remote add oscgit https://git.oschina.net/user/repogit push -u oscgit --all

    通常来说,如果本地存在 SVN 仓库,则可以:

    git svn clone file:///tmp/svn-repo -T trunk -b branches -t tagsgit remote add oscgit https://git.oschina.net/user/repogit push -u oscgit  --all

    将项目转移到 GIT@OSC 上以后,使用 svn 命令 checkout 即可对项目进行操作。

    高级指南:http://git-scm.com/book/zh/ch8-2.html

    安装 git,git-svn

    Windows

    msysgit 官网http://msysgit.github.io/,版本比较低。

    Github for Windows 提供的 git 工具和 msysgit 一致。

    MSYS2 git 下载地址:http://sourceforge.net/projects/msys2,然后启动终端,安装 git,目前版本为2.4.3。

    pacman -S git

    Cygwin git 下载地址:http://www.cygwin.com/,然后使用包管理软件或者直接下载 git 源码编译 git。

    makeconfigure./configure --prefix=/usr/localmakemakeinstall

    Linux

    有包管理器的直接用包管理器安装。

    如 Ubuntu

    sudoapt-get install git git-svn

    也可以手动编译。

    Mac OSX

    下载地址:http://git-scm.com/download/mac

    相关文章

      网友评论

        本文标题:码云SVN支持

        本文链接:https://www.haomeiwen.com/subject/ferdwttx.html