Go Engineering - Makefile
基础语法 https://github.com/seisman/how-to-write-makefile 规则语法 伪目标 变量赋值 特殊变量 自动化变量 功能设计Target Target Desc gen Generate all necessary files, such as error code files. format Gofmt (reformat) package sources (exclude vendor dir if existed). lint Check syntax and styling of go sources. test Run unit test. cover Run unit test and get test coverage. build Build source code for host platform. build.multiarch Build source code for multiple platforms. See option PLATFORMS. image Build docker im...
Go Engineering - RPC API
RPC Client Stub / Server Skeleton Client 通过本地调用，调用 Client Stub Client Stub 将参数打包（Marshalling）成一个消息，并发送这个消息 Client 所在的 OS 将消息发送给 Server Server 端接收到消息后，将消息传递给 Server Stub Server Stub 将消息解包（Unmarshalling）得到参数 Server Stub 调用服务端子函数，处理完毕后，将最终结果按相反步骤返回给 Client gRPC Google Remote Procedure Call 简介 由 Google 开发的高性能、开源、跨语言的通用 RPC 框架 基于 HTTP 2.0 协议 + 默认采用 Protocol Buffers 数据序列化协议 特征 支持多语言 - Go、Java、C++、Node.js、Python 等 基于 IDL - Interface Definition Language 文件定义服务 通过 proto3 工具生成指定语言的数据结构、Server API 以及 ...
Go Engineering - RESTful API
概念 Representational State Transfer REST 只是一种软件架构风格 REST 有一系列规范，满足这些规范的 API 称为 RESTful API REST 规范将所有内容都视为资源，REST 架构对资源的操作对应 HTTP 协议提供的方法 REST 风格适用于很多传输协议，并且 REST 天生与 HTTP 协议相辅相成 HTTP 协议成为了实现 RESTful API 的事实标准 REST 是一种规范，而 RESTful API 是满足 REST 规范的 API 接口 RESTful API 的核心是规范 特点 以资源为中心，所有东西都抽象成资源，所有行为都应该在资源上的 CRUD 操作 资源对应 OOP 中的对象 资源使用 URI 标识，每个资源实例都有唯一的 URI 标识 资源是有状态的，使用 JSON/XML 等在 HTTP Body 里表征资源的状态 客户端通过 HTTP 动词，对服务端资源进行操作，实现 Representational State Transfer 操作是无状态的，每个 RESTful API 请求都包...
Go Engineering - Design Pattern
设计模式 创建型模式 提供了一种在创建对象的同时隐藏创建逻辑的方式 单例模式饿汉方式 在包被加载时创建 12345678910package singletontype Singleton struct {}var instance *Singleton = &Singleton{}func GetInstance() *Singleton { return instance} 懒汉方式 在第一次使用时创建 - 使用最多，但非并发安全，需要加锁 不加锁1234567891011121314package singletontype Singleton struct {}var instance *Singleton// GetInstance is not thread-safefunc GetInstance() *Singleton { if instance == nil { instance = &Singleton{} ...
Go Engineering - Elegant Project
优雅项目 Go 应用 代码结构 按功能拆分 - Kubernetes / Docker / Helm / Prometheus 代码规范 编码规范 - https://github.com/xxjwxc/uber_go_guide_cn 静态代码检查 - https://github.com/golangci/golangci-lint 最佳实践 https://go.dev/doc/effective_go https://go.dev/wiki/CodeReviewComments https://rakyll.org/style-packages/ 代码质量 单元测试 可测试 将依赖的数据库等抽象成接口，在被测代码中调用接口的方法，在测试时传入 Mock 类型 尽量减少 function 中的依赖 + 依赖是容易 Mock 的 高覆盖率 Code Review Mock 工具 https://github.com/golang/mock 官方 Mock 框架，与 Golang 内置的 testing 包集成，最常用 实现基于 interface...
Go Concurrency - Mutex Basic
基本概念临界区 临界区 - 共享资源 使用互斥锁，限定临界区只能同时由一个线程持有 当临界区被一个线程持有时，其它线程想进入，只能失败或者等待 直到持有的线程退出临界区后，其它等待的线程才有机会去竞争该临界区 在 Go 标准库中，使用 Mutex 来实现互斥锁 - 使用最为广泛的同步原语 同步原语：解决并发问题的基础数据结构 同步原语适用场景 共享资源 - Mutex / RWMutex 任务编排 - WaitGroup / Channel 消息传递 - Channel 基本用法Locker Locker 接口定义了锁同步原语的方法集 1234567package sync// A Locker represents an object that can be locked and unlocked.type Locker interface { Lock() Unlock()} Mutex12func (m *Mutex) Lock()func (m *Mutex) Unlock() 当一个 goroutine 通过 Lock...
FaaS - WebIDE
架构 组成 蓝色部分 WebIDE 客户端的核心 Run VS Code on any machine anywhere and access it in the browser 绿色部分 将 WebIDE 与 FaaS 结合的核心 橘色部分 Serverless 形态下的必备支撑服务 过程 用户在 VS Code 的前端页面向后端发出函数在线编辑的请求 服务端，即 FaaS 的 Controller 在接收到请求并验证权限后，再转给 VS Code Server 容器实例 VS Code Server 容器实例会获取用户代码，然后再加载 FaaS 的资源调度系统 根据目前 Container Pool 中的资源现状，动态扩缩容 WebIDE Pod 资源 VS Code Server 根据用户请求，会调用 Serverless Extension BE 基于此时语言的环境，执行操作，并将执行结果返回给 Client 端 注意 可以将 Serverless Extension 插件提前集成在 VS Code Server 的镜像中 FaaS Runtime 依据原来函数计...
FaaS - Function Invoke
函数拆分 成本 云函数的收费：调用次数、公网流量、占用资源时间（最贵） 复用 组件化 性能 对于非串行的功能，拆分成多个函数可以提高并发性 调用方式 同步、异步、编排（具有调度和管理的语义） 同步 需要注意调用延迟和超时带来的费用成本 直接调用 使用云厂商提供的 SDK，调用指定的函数，实现直接调用 12345678import fc2client = fc2.Client( endpoint='<Your Endpoint>', accessKeyID='<Your AccessKeyID>', accessKeySecret='<Your AccessKeySecret>')// 同步调用client.invoke_function('service_name', 'function_name') 网关调用 通过 API 网关调用函数，借助 API 网关来...
FaaS - Runtime
概述 一般的编程语言都有自身的运行时，运行时的主要职责是可以让代码和机器交互，进而实现业务逻辑 函数计算运行时 能够让函数在机器或者容器中执行起来，实现业务逻辑的执行环境 通常由特定语言构建的框架构成 函数计算运行时依赖于语言运行时 函数计算运行时的本质：让函数在容器中执行起来的代码框架 在函数实例初始化时，函数计算运行时一般会由一个初始化进程加载起来 然后函数计算运行时就可以准备接收请求 当请求到达后，业务代码会被对应的语言运行时中加载进来处理请求 Runtime 是一个特定语言环境下的服务框架环境 该服务将以一个进程的形态运行在用户容器中，并与用户代码相关联 该服务启动后，会一直等待请求的到来，一旦请求到达后，Runtime 会关联业务代码去执行（并发） 原理语言类型编译型语言 C/C++/Go，在编译时将所有用到的静态依赖、源码一起打包，编译完后可以直接运行 Java，经过编译产生的字节码需要 JVM 再次将其转换为机器码，同时具有编译型和解释型的特性 通常需要将所有依赖包打包成一个 jar 包或者 war 包，符合编译型语言的风格 在开发函数时，需...
