api-server

API Server

Nautes 的设计是遵循了 GitOps 的最佳实践，将用户应用环境以及 Nautes 自身环境的声明均存储在版本库中。声明数据分为两类：密钥数据是存储在 Vault 中，其他数据是存储在 Git（目前只支持 GitLab）仓库中，API Server 项目则是提供了一组用于操作这些声明数据的 REST API。

功能简介

API Server 提供的 API 分为两类：租户侧和用户侧。

API文档

如果您是在本地启动 API Server 的服务，可以通过下面的地址访问 swagger-ui 风格的 API 文档。

https://$api-server:$port/q/swagger-ui

您也可以通过在线文档浏览 API 的定义。

快速开始

准备

安装以下工具，并配置 GOBIN 环境变量：

• go
• protoc
• protoc-gen-go
• kratos
• kubectl

1、准备一个 kubernetes 实例，复制 kubeconfig 文件到 {$HOME}/.kube/config

创建 nautes-configs 配置文件

kubectl create cm nautes-configs -n nautes

2、访问其他组件的证书

默认情况下，安装环境完成后，在/opt/nautes/out/pki目录下会生成用于存在访问其他组件的证书和签发证书的CA，请检查该目录下是否包含api-server.key，ca.crt等证书文件

3、设置环境变量

api-server会根据一份资源布局配置文件来校验和生成资源。本地开发时，可以通过设置环境变量的方式启动项目，该文件位于当前项目下的 pkg/nodestree/sample/resources.yaml

export RESOURCES_LAYOUT = ${workspaceFolder}/pkg/nodestree/sample/resources.yaml

构建

make build

运行

kratos run

单元测试

go test -v ./...