发表于

第一步：用户映射

创建用户映射 （例如 users.txt） ，将 SVN 用户和 Git 用户对应起来，为保留提交记录做准备。

进入 SVN 的目录，执行如下命令，注意其中 $1\@tencent.com 部分应当替换为你实际的映射关系。

1
2
3
4
5
6
7
8
$ svn log --xml | grep -P "^<author" | sort -u | \
    perl -pe 's/<author>(.*?)<\/author>/$1 = $1 <$1\@tencent.com>/' > users.txt

# 或

$ svn log -q svn+ssh://your/svn/path | \
    awk -F '|' '/^r/ {sub("^ ", "", $2); sub(" $", "", $2); print $2" = "$2" <"$2"@tencent.com>"}' | \
    sort -u > users.txt

注意，生成的 users.txt 文件应当以 ANSI 编码保存，并且使用 CRLF 换行，您可以使用记事本另存为的功能选择该编码。

第二步：克隆代码

创建一个用于存放 Git 本地仓库的文件夹，如：E:/git，进入该文件夹，执行 clone 命令。

1
2
cd /e/git
git svn clone svn+ssh://your/svn/path -r 2000:HEAD --no-metadata --authors-file=users.txt --trunk=.

该步骤除了 clone 代码之外，还将导入所有的提交记录，执行较慢，需要耐心等待。中途出现找不到作者的情况时，可以修改 users.txt 补充该作者，重新再执行 git svn clone 命令。

详细命令参数，请参考 git svn help clone。

执行完成之后，会在 E:/git 目录下创建以你 SVN path 最后一节为名称的子目录，可以进入该目录下的 .git 文件夹，执行 git log 命令查看提交记录。

第三步：提交到 GIT

这个步骤和常规地创建 GIT 仓库没有任何区别，直接添加远程仓库地址，push 即可：

1
2
git remote add origin http://your/remote/git/path.git
git push -u origin master

至此，代码及提交记录从 SVN 迁移到 GIT 的工作全部完成。

参考链接：

发表于 | 更新于

译者注

本文为 QCon 2018 上海站主题演讲嘉宾、Heptio 资深工程师、著名 Go 语言专家 David Cheney 关于 Go 语言实践的英文分享。为方便大家阅读，在此由 Austin Luo 翻译为中文，在文中难以理解之处，也特别增加了译者的理解说明。翻译水平有限，如有偏颇之处，烦请联系我（uonun@163.com）更正。转载请注明出处，保留本节译者注。

目录

  • 指导原则
    • 简单性
    • 可读性
    • 生产率
  • 标识符
    • 选择清晰的名称，而不是简洁的名称
    • 标识符长度
    • 命名中不要包含所属类型的名称
    • 使用一致的命名风格
    • 使用一致的声明风格
    • 成为团队合作者
  • 代码注释
    • 变量和常量上的注释应当描述它的内容，而非目的
    • 总是为公开符号写文档说明
  • 包的设计
    • 一个好的包从它的名称开始
    • 避免将包命名为 base、common、util
    • 快速返回，而不是深层嵌套
    • 让零值变得有意义
    • 避免包级别的状态
  • 项目结构
    • 考虑更少，更大的包
    • 确保 main 包越小越好
  • API 设计
    • 设计难以被误用的 API
    • 针对默认用例设计 API
    • 让函数自身定义它所需的行为
  • 错误处理
    • 通过消除错误来消除错误处理
    • 错误只处理一次
  • 并发
    • 保持自己忙碌，否则自己做
    • 将并发留给调用者
    • 不要启动一个永不停止的协程

引言

接下来这两场我将给大家一些编写 Go 代码的最佳实践。

今天这是一个研讨会风格的演讲，我会摒弃那些绚丽的 PPT，而是使用您们可以直接带走的文档。

您可以在这里找到这个演讲最新的在线版本：
https://dave.cheney.net/practical-go/presentations/qcon-china.html

阅读全文 »

发表于

打开 Visual Studio Code 的设置，按如下配置即可：

1
2
3
4
5
{
  // 找到您的 git 目录
  "terminal.integrated.shell.windows": "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
  "terminal.integrated.shellArgs.windows": ["--login", "-i"]
}

发表于

场景：

  • SSH 跳板机：10.0.0.1
  • MySQL 数据库：10.0.0.2:3306

MySQL 部署的机器不允许 SSH 连接，并且数据库端口只允许 localhost 或 10.0.0.1 这台跳板机访问，此时本机可以通过 ssh 连上跳板机，通过 ssh 建立的隧道端口转发连接上 MySQL 数据库。

阅读全文 »

发表于

架构是这样定义的

  • 每个系统都有一个架构
  • 架构由架构元素以及相互之间的关系构成
  • 系统是为了满足 利益相关者（stakeholder） 的需求而构建的
  • 利益相关者都有自己的关注点（concerns）
  • 架构由架构文档描述
  • 架构文档描述了一系列的架构视角
  • 每个视角都解决并且对应到利益相关者的关注点。

架构师的首要任务是尽最大可能找出所有利益相关者，业务方，产品经理，客户/用户，开发经理，工程师，项目经理，测试人员，运维人员，产品运营人员等等都有可能是利益相关者，架构师要充分和利益相关者沟通，深入理解他们的关注点和痛点，并出架构解决这些关注点。架构师常犯错误是漏掉重要的利益相关者，沟通不充分，都会造成架构有欠缺，不能满足利益相关者的需求。利益相关者的关注点是有可能冲突的，比如管理层（可管理性）vs技术方（性能），业务方（多快好省）vs 技术方（可靠稳定），这需要架构师去灵活平衡，如何平衡体现了架构师的水平和价值。

阅读全文 »

发表于 | 更新于
阅读全文 »

发表于

我们在后端系统实现了 HTTP 请求的代理类，用于请求其他第三方系统。大致的请求流程是这样的：

消费系统不能直接请求业务系统的 HTTP 接口，需要由中间的 HttpHelper 代理请求。其中 HttpHelper 接受消费系统传入的各种参数，包括要请求的 URL、METHOD、HEAD、BODY 等，在实际生产中一直运行得很好，直到如下异常的出现：

1
2
System.Net.CookieException: Cookie format error.
   at System.Net.CookieContainer.CookieCutter(Uri uri, String headerName, String setCookieHeader, Boolean isThrow)
阅读全文 »

发表于

引言

作为一个软件系统，需要写日志，这是不言而喻的，这是大家都会不假思索地说“那当然”的事。不论是什么语言，写日志的专用框架也不一而足，写到文本的，写到数据库的，写到队列的，写到Redis的等等等等。对于日志的几个级别，Trace、Debug、Warning、Error、Fault，大家也能够如数家珍。但是，有多少人能够回答下面这几个问题呢？

为什么需要写日志？
什么时候写日志？
日志是写给谁看的？
日志里都要写什么？
日志的组织形式应该怎样？

接下来，我尝试一一地解答这些问题，说说我的理解。

阅读全文 »

发表于

以下以 VS 的编译工具包为例，实际上 VS IDE 本身也可以如此进行。

一、下载在线安装文件

  1. 进入下载页：https://www.visualstudio.com/zh-hans/downloads/
  2. 选择最底部的 Other Tools and Frameworks -> Visual Studio 2017 生成工具 并下载。
  3. 以管理员身份运行刚刚下载的在线安装文件，注意带参数：--layout "F:\software\VS2017 BuildTool\Offline" --lang zh-CN

此时将开始下载安装所需文件：（如果断电断网或者关闭了下载窗口，没关系，输入命令重头来过，还是会继续下载的）

阅读全文 »