zoukankan      html  css  js  c++  java
  • svn的使用

    概要

    概述

            SAE自2011-7-10日起,将全面支持SVN代码部署,用户不仅能够通过不论什么SVNclient部署代码,并且SAE现有的代码部署方式也已经对接应用的SVN仓库。即使不使用SVNclient部署代码,也保证了代码版本号。

            如:通过在线代码编辑器(http://sdk.tools.sinaapp.com)等方式对代码的改动、部署等操作也会像svn commit一样。产生一个新版本号。通过SVNclientsvn update能够获取近期的更新。也能够通过svnclient回滚代码。

    SVN仓库地址:  https://svn.sinaapp.com/your_app_name (您能够通过此地址直接訪问)

    如:应用域名是 test.sinaapp.com,那么SVN仓库地址是:https://svn.sinaapp.com/test

    SVNusername:  SAE安全邮箱    

    SVNpassword:  SAE安全password(如已启用微盾动态password。则此处填写“安全password”+“微盾动态password”)

    注:SVNusername和password为安全邮箱和安全password,不是微博账号和微博password。

    与标准SVN的差别

      为了保持与SAE兼容,使用svn方式部署代码到SAE有例如以下限制:

        1、文件名称或文件夹名不同意含有下面字符:",*,?,<,>,|,另外文件或文件名称的開始与结束也不允             许有空格。

        2、上传单个文件大小不超过20M

        3、单个文件夹下的文 件个数不能超过2000个

        4、每一个应用代码总大小不超过100M

        5、单个版本号代码总大小不超过50M

        6、appname文件夹下仅仅同意存在10个以内的版本号,而且版本号号必须为正整数。

    (也就是说appname以下仅仅同意出现10个以内的正整数             文件夹名,不同意有非文件夹的存在)

    代码部署原理

      SAE代码部署分为三步:

      创建应用

            登陆SAE在线管理平台,“创建新应用”(http://sae.sina.com.cn/?m=myapp&a=create)时,如果创建成功,系统会自己主动为该应用创建一个SVN仓库。如果新创建的应用名为newapp。那么仓库地址为:

            https://svn.sinaapp.com/newapp/

            此时。能够通过本地SVNclient检出(checkout)该应用的本地工作文件夹。

      部署代码

         SAE提供了不同的代码部署方式,能够分为两类:

              一是通过SVNclient部署。这是SAE推荐的代码部署方法。

              还有一个是通过非SVNclient部署,即在线代码在线编辑器和推荐应用安装。

            这两类代码部署方法都会更新应用的SVN仓库版本号,但必须注意的是非SVNclient部署方式无法提供版本号管理功能,仅仅能看到最新版本号的代码,也无法回滚代码。

            因此。强烈建议仅使用SVNclient方式部署代码,假设同一时候使用非SVNclient方式部署,为避免代码版本号冲突,请及时在本地SVN工作文件夹下运行svn update操作,保证本地工作文件夹与线上代码保持一致。

      验证

            代码更新后,通过svn update或直接通过浏览器訪问应用查看代码是否已经更新到线上。

    相关资源

      TortoiseSVN下载:http://tortoisesvn.net/downloads.html

      Subversion中文站:  http://www.subversion.org.cn/

    Windows SVN

    使用TortoiseSVNclient

            在Windows下推荐使用乌龟(Tortoise)SVNclient。

    TortoiseSVN 是 Subversion 版本号控制系统的一个免费开源client。能够超越时间的管理文件和文件夹。

    文件保存在中央版本号库(即SAE中央SVN仓库),除了能记住文件和文件夹的每次改动以 外。版本号库很像普通的文件server。你能够将文件恢复到过去的版本号,而且能够通过检查历史知道数据做了哪些改动,谁做的改动。这就是为什么很多人将 Subversion 和版本号控制系统看作一种“时间机器”。

    下载安装

       TortoiseSVN下载:http://tortoisesvn.net/downloads.html

    又不是在linux下,安装就不多说了 :)

    以下具体介绍使用TortoiseSVN向SAE部署代码。

    创建本地工作文件夹

            第一步,如图1,创建一个新文件夹作为本地工作文件夹(Working directory)。能够使用应用名为文件夹名。

    如。为我的应用devcenter创建本地工作文件夹。

      第二步,从SAE的SVN仓库检出(checkout)一个应用的所有版本号代码,如图2,右键-->点击“SVN Checkout”

      在弹出页面中填写仓库路径就可以。这里是:https://svn.sinaapp.com/devcenter/。其他默认參数就可以。如图3:

      Reversion处,“HEAD revision”是指最新版。也能够指定Revision为随意一个版本号。

      点击“OK”,出现下载界面,如图4:

      假设一切顺利,devcenter应用所有版本号代码将会所有出如今刚刚创建的devcenter目录下,如图5:

    改动代码

      在本地使用你喜欢的编辑器,编辑随意文件,保存后该文件图标将会出现红色感叹号,如图6所看到的:

            看,刚刚改动过的index.php变色了。

    以下须要提交(commit)近期的更新。

    在index.php文件上击右键,出现菜单 ,

    选择“SVN commit”。如图7:

      然后填写关于本次更新的日志(log message)。这是必填项,否则commit会失败。如图8:

      当您看到如图9所看到的,表明刚才的改动已经成功提交,而且前该devcenter项目的SVN版本加1。变成30.

    新增文件/目录

            在 SVN工作文件夹下,对于文件改动。完毕后仅仅须要commit就ok了。但对于新增文件。或者从其他文件夹复制进来的文件或文件夹。须要在commit之前需 要做一步add操作,即将文件或文件夹加入到svn工作文件夹中来,否则SVNclient不认它。详细操作非常easy,如图10:

      然后再如图7所看到的,右键commit 就可以。

      很多其它Tortoise SVN使用帮助。请參阅:http://www.subversion.org.cn/tsvndoc/

    Notepad++集成svn插件

      Notepad++ 是一款Windows环境下非常受欢迎的免费开源的代码编辑器。有非常丰富的第三方插件。

      以下介绍Notepad++的svn插件的安装及使用。

        如图12,点击Plugin --> Plugin Manager --> Show Plugin Manager

        打开后,在“Available”页找到“Subversion”,然后点击“Install”。如图13所看到的:

        成功安装后会在Plugins菜单下出现"Subversion"子菜单。

                打开之前checkout下来的任一文件,如devcenter/1/index.php,编辑完毕后,点击Plugins --> Subversion --> Commit File(或使用    快捷键Ctrl+Alt+A)

        出现熟悉的一页,如图14所看到的:

        对,这就是乌龟SVN的Commit页面。输入Log Message,点击“OK”就可以提交。

    使用UltraEdit Studio部署

        UltraEdit Studio(注意不是UltraEdit,UltraEdit不能与SVN整合)配置略微复杂些。

        第一步,SVN仓库账号设置,如图15所看到的:

        然后填写仓库信息。如图16所看到的:

        完毕后,创建Project,如图17所看到的:

            填写project名b.prj后,出现如图18所看到的"Project Settings"。点击“Add Folder”,出现“NewFolder”,将"Group"前的勾去掉,然后点击“Browse”,在“Browse for Folder”页找到之前checkout出现的本地工作文件夹。

        点击“OK”后出现提示,如图19所看到的:

        表明UEStudio自己主动识别出了选择的代码文件夹是一个SVN工作文件夹,并询问是否整合,点击“Yes”,出现如图20所看到的:

        大功告成,"Close"之后即能够编辑代码。并随时commit改动。如图21所看到的:

    使用EditPlus部署

        EditPlus依赖于Tortoise SVN(TSVN),必须先安装。

        使用最简单,见图22所看到的:

    当编辑SVN工作文件夹里的文件时,File --> TSVN即出现对应可操作的菜单。

    Linux/Mac SVN

    仓库地址

    https://svn.sinaapp.com/appname/

        为了传输安全。SAE要求统一使用https方式部署代码。

    创建仓库

          登陆SAE在线管理平台(http://sae.sina.com.cn),创建应用,成功后您即能够检出该应用代码。

          比如,您刚刚创建了应用newapp。在本地运行:

              svn checkout https://svn.sinaapp.com/newapp

          第一次checkout时须要验证,username/password为您的SAE安全邮箱和安全password(非微博登陆账号password,如已启用微盾动态password。则此处填写“安全password”+“微盾动态password”)。

    创建版本号

          假如,为newapp应用创建版本号1

          眼下提供两种方式:

    使用svnclient

    svn checkout https://svn.sinaapp.com/newapp  #此处须要认证,username/password为您的SAE安全邮箱和安全password(如已启用微盾动态password,则此处填写“安全password”+“微盾动态password”)

    cd newapp

    mkdir 1

    svn add 1

    svn commit -m"add version 1 for newapp"

    使用在线管理平台

              在SAE在线管理平台“代码管理”处创建版本号就可以。但为了避免与本地仓库冲突,务必在本地工作文件夹下运行:svn update ,将近期的更新拉到本地来。

    更新代码

              更新代码前本地必须有一个工作文件夹(Working Directory),创建工作文件夹非常easy。仅仅须要检出(checkout)代码仓库就可以。如。对于已经创建好的应用newapp。在本地运行:

         svn checkout https://svn.sinaapp.com/newapp

              输入安全账号和安全password。即完毕本地工作文件夹的创建。

    上传代码

          须要添加某个文件或目录,如部署wordpress到版本号1。

    svn checkout https://svn.sinaapp.com/newapp

    cd newapp/1

    cp -rf /path/to/wordpress/* ./

    svn add ./*

    svn commit -m"add wordpress"

    改动代码

          假如须要改动newapp应用版本号1根文件夹下某个文件。如index.php,完整的操作流程例如以下:

    svn checkout https://svn.sinaapp.com/newapp    #假设已经checkout过了,不须要又一次checkout。

    cd newapp/1

    vim index.php   #这里编辑代码

    svn commit -m "edit index.php"

    配置应用(appconfig)

            在应用版本号根文件夹下。如newapp/1下。创建文件config.yaml(语法參见:http://sae.sina.com.cn/?m=devcenter&catId=193),然后通过svn commit就可以完毕应用配置。

            如,如今须要更新应用newapp的默认版本号3的appconfig,操作例如以下:

        svn checkout https://svn.sinaapp.com/newapp    #假设已经checkout过了,不须要又一次checkout。

        cd newapp/3

        vim config.yaml   #这里依照config.yaml语法编辑就可以。

        svn commit -m "update config.yaml"

            注意:config.yaml不会被部署到用户的代码文件夹,但会被存储在服务端SVN仓库中。因此下次能够被checkout出来。但不会被用户訪问到。

    在线编辑代码

          SVN能够在线阅读应用代码,地址即SVN仓库地址:https://svn.sinaapp.com/appname/

          将appname换成自己的应用名就可以登陆查看代码。

          在线编辑器 可在管理面板>>代码管理>>编辑代码 打开

    SVN for SAE的限制条件

          为了保持与SAE兼容,使用svn方式部署代码到SAE有例如以下限制:

          1、文件名称或文件夹名不同意含有下面字符:",*,?,<,>,|。另外文件或文件名称的開始与结束也不同意有空格。

          2、上传单个文件大小不超过4M

          3、单个文件夹下的文 件个数不能超过400个

          4、每一个应用代码总大小不超过100M

          5、单个版本号代码总大小不超过50M

          6、appname文件夹下仅仅同意存在10个以内的版本号,而且版本号号必须为正整数。(也就是说appname以下仅仅同意出现10个以内的正整数             文件夹名。不同意有非文件夹的存在)

    常见错误说明及解决的方法

    错误提示
    错误原因
    解决方法

    The change log need some words(not null)
    提交时没有加入log message
    提交时加上log message就可以

    The log message is a pathname (was -F intended?); use '--force-log' to override
    log message 与路径名称同样
    改动log message

    Error file xxx in not allowed in root directory!
    working copy的根文件夹下不同意有名为xxx的文件(仅仅能是正整数版本号文件夹)
    删除该文件或者移到到版本号文件夹下

    directory xxx/ is not allowed in root directory! Only positive integer dirs are allowed!

    working copy的根文件夹下不同意有名为xxx的文件夹(仅仅能是正整数版本号文件夹)
    删除该文件夹或者移到版本号文件夹下

    Too many versions!(less than 10 is permited)
    版本号文件夹多于10个,最多不超过10个
    删除刚刚创建的版本号文件夹就可以。

    Too many files: XXX (less than 2000 is allowed).
    XXX文件夹下文件的数量超过2000
    删除XXX文件夹下的文件,使其总数降至2000下面

    dir APPNAME/dir(size:xxxx) is too large less than xxx
    该应用下代码(不包含.svn文件夹)总大小超过100M。或某个版本号总大小超过50M
    删除不必要的代码再尝试提交

    File XXX is too large!(less than 4M)
    单个文件大小超过4M
    删除重试

    类似Repository UUID '305daf1b-94be-48ee-a4b9-f4bcd36320de' doesn't match expected UUID '44e2f7a2-1b69-4710-974a-b6edef0fdc12'
    server端仓库被删除重建。client对原仓库进行操作导致。
    又一次checkout出一份代码就可以

    add vers xxx faild
    文件部署失败
    内部原因。请联系saesupport@sina.cn。

    经常使用svn命令说明

        1、从SVN仓库中检索出代码到工作拷贝:

               # svn checkout https://svn.sinaapp.com/appname [workcopy]

               当中workcopy是可选的,假设不写workcopy,SVN会默认将appname做为workcopy。

               假设仅仅检索某个版本号:

               # svn checkout https://svn.sinaapp.com/appname/appversion [workcopy]

               仅仅检索某个版本号的某个文件夹:

               # svn checkout https://svn.sinaapp.com/appname/appversion/folder [workcopy]

        2、向SVN仓库提交代码:

               # svn commit -m "here is message"

        3、将本地文件加入到工作拷贝:

               # svn add something

               注:假设something为文件,svn会将这个文件加入到工作拷贝。假设something是文件夹。svn会将文件夹及里面的文件全加入到工作                      拷贝。something也能够是通配符*,这样会忽略已经加入过的文件。

        4、从工作拷贝中删除一个文件:

               # svn delete something

               注:假设something为文件,svn会将这个文件从工作拷贝中删除;假设something是文件夹,svn会将文件夹及里面的文件所有从工作                      拷贝中删除。

        5、直接从SVN仓库中删除文件:

               # svn delete -m "delete something" https://svn.sinaapp.com/appname/appversion/something

               注:能够从SVN仓库中直接删除单个文件或单个文件夹甚至某个版本号。

        6、将一个本地项目导入到SVN仓库:

               导入应用的某个版本号:

               # svn import localdir https://svn.sinaapp.com/appname/appversion

               注:要确保眼下应用的appversion不冲突。

        7、查看工作拷贝中的文件或文件夹状态:

               # svn status [something]

        8、更新自己的工作拷贝:

               # svn update

               注:从SVN仓库下载最新版本号,此命令会导致本地没有提交的更改丢失。建议使用此命令前先查看一下本地拷贝状态(svn status).

        9、取消对代码改动

               取消对代码的改动分为两种情况。

    第一种情况:修改没有被提交(commit)。

               这样的情况下,使用svn revert就能取消之前的改动。

               svn revert使用方法例如以下:

               # svn revert [-R] something

               当中something能够是(文件夹或文件的)相对路径也能够是绝对路径。

               当something为单个文件时。直接svn revert something即可了;当something为文件夹时。须要加上參数-R(Recursive,递归),否则              仅仅会将something这个文件夹的修改。

               在这样的情况下也能够使用svn update命令来取消对之前的改动,但不建议使用。由于svn update会去连接仓库server。耗费时间。

               注意:svn revert本身有固有的危急,由于它的目的是放弃未提交的改动。一旦你选择了恢复,Subversion没有方法找回未提交的修                        改。

    另外一种情况:修改已经被提交(commit)。这样的情况下。用svn merge命令来进行回滚。

               回滚的操作步骤例如以下: 

                 1) 保证我们拿到的是最新代码: 

                      svn update 

                      如果最新版本是28。 

                 2) 然后找出要回滚的确切版本: 

                      svn log [something]

                      如果依据svn log日志查出要回滚的版本是25,此处的something能够是文件、文件夹或整个项目

                      假设想要更具体的了解情况,能够使用svn diff -r 28:25 [something]

                 3) 回滚到版本25:

                      svn merge -r 28:25 something

                      为了保险起见。再次确认回滚的结果:

                      svn diff [something]

                      发现正确无误,提交。

                 4) 提交回滚:

                      svn commit -m "Revert revision from r28 to r25,because of ..." 

                      提交后版本号变成了29。

                      将以上操作总结为三条例如以下:

                      a. svn update,svn log,找到最新版本号(latest revision)

                      b. 找到自己想要回滚的版本(rollbak revision)

                      c. 用svn merge来回滚: svn merge -r : something

        10、查看SVN仓库日志信息:

                # svn log [workcopy]

                查看全部本地的历史日志,假设workcopy为某文件,那么就是查看某个文件的日志信息。

                查看SVN仓库全部文件的日志信息:

                # svn log https://svn.sinaapp.com/appname/

                这个命令会查看全部改动过的日志。

        注:SAE提供的SVN服务全然支持标准SVN的全部命令。更具体的使用说明请查阅SVN官方帮助文档。

                SVN命令帮助文档:http://www.subversion.org.cn/svnbook/1.4/svn.ref.html

                中文全然帮助文档:http://svnbook.red-bean.com/index.zh.html

  • 相关阅读:
    dmesg
    [转]df命令
    [转]linux /proc/cpuinfo 文件分析
    awk
    sed
    [转]进程间通信
    Bootstrap 树形列表与右键菜单
    Maven国内仓库
    《深入剖析Tomcat》源码
    Spring in Action学习笔记(2)
  • 原文地址:https://www.cnblogs.com/mengfanrong/p/5187306.html
Copyright © 2011-2022 走看看