Gel `instance create` 完全指南：初始化本地与 Gel Cloud 实例

数据库图数据库关系型数据库【免费下载链接】edgedbGel supercharges Postgres with a modern data model, graph queries, Auth AI solutions, and much more.项目地址https://gitcode.com/gh_mirrors/ed/edgedb点击查看免费下载导读gel instance create是 Gel 命令行工具CLI中用于初始化新 Gel 实例的核心命令它不仅负责创建本地实例还会自动在gel_config_dir/credentials目录下生成对应的凭据credentials文件供后续客户端连接使用。无论是想在本地快速起一个开发实例还是作为 Gel Cloud 用户通过 CLI 创建云端实例本文都能让你完整掌握该命令的语法、全部选项、命名约束与版本选择技巧并了解其底层行为与相关配套命令。命令总览gel instance create的完整语法如下gel instance create [options] [name] [default-branch-or-database]它是一条终端命令作用是创建一个新的 Gel 实例并在gel_config_dir/credentials下创建对应的凭据文件。要查看你机器上gel_config_dir的具体路径运行gel info注意instance create命令不适用于自托管self-hosted实例。如果你需要创建自托管实例请参照 deployment guides 等部署指南操作。从源码结构看Gel CLI 本身已经迁移为 Rust 实现——仓库中的 edb/cli/init.py 里的rustcli()函数会通过os.execvpe(gel, args, os.environ)直接转发执行gel命令因此本文所有命令均以gel为入口。本地实例的创建流程最基础的用法是直接创建实例实例名会被交互式询问gel instance create也可以在命令行中直接指定名称gel instance create demoxy执行成功后CLI 会在gel_config_dir/credentials下生成以实例名命名的凭据文件。该文件记录了连接所需的信息如用户、端口、数据库、TLS 配置等后续通过gel命令或客户端连接时即可自动读取。你可以通过 gel instance credentials 查看或导出某个实例的凭据也可以运行gel info查看当前配置目录与凭据目录的准确位置。新实例的默认分支Branch创建实例时可以指定默认分支名作为第二个位置参数gel instance create demoxy main该分支将作为新实例上的默认分支|main|。默认值规则如下新版本实例默认分支为main创建 pre-v5 版本实例时默认分支为edgedb。首次初始化连接创建完成后推荐使用以下命令验证实例状态gel instance status gel instance list前者显示实例运行状态后者列出所有本地实例及其端口、版本等信息二者均可配合 gel instance start 对实例进行管理。全部选项详解name实例名称新 Gel 实例的名称若未指定则交互式询问。branch-or-database-name默认分支名新实例上的默认分支名默认值为mainpre-v5 实例为edgedb。--nightly为实例使用 nightly 版本服务器。--default-userdefault-user指定默认用户名该用户会在实例初始化时被创建并写入凭据文件。默认值为adminpre-v6 实例为edgedb。示例gel instance create --default-usermyuser demoxy--portport指定实例监听的端口。默认情况下会使用一个随机端口并记录在凭据文件中。若需要固定端口例如为防火墙或代理做准备可以显式指定gel instance create --port5656 demoxy--start-confstart-conf配置新实例的启动方式可选值取值行为auto随系统或用户会话自动启动默认值manual关闭自动启动需要时手动通过 gel instance start 启动示例gel instance create --start-confmanual demoxy--channelchannel指定新实例的发布通道channel可选值为stable稳定版通道testing测试版通道nightly每晚构建通道。--versionversion指定用于运行新实例的 Gel 服务器版本。可通过 gel server list versions即ref_cli_gel_server_list_versions列出当前可用的版本。版本选择规则指定主版本号如X.0时CLI 会安装该主版本下的最新发布版。例如以下命令安装最新的 X.Y 版本gel instance create --version X.0 demoxy若想锁定精确版本在版本号前加等号。以下命令安装精确的 X.Y 版本gel instance create --version X.Y demoxy注意某些 shell如 ZSH可能需要转义等号\X.Y或给版本字符串加引号X.Y以避免 shell 将X.Y解析为特殊参数。Gel Cloud 实例的创建Gel Cloud 用户可以使用该命令创建云端实例前提是已通过gel cloud login即ref_cli_gel_cloud_login完成登录。详见 Gel Cloud CLI 文档。命名规范创建 Cloud 实例时实例名必须采用org-name/instance-name格式。Cloud 实例名可包含字母数字字符和连字符-。Cloud 实例命名限制使用 Gel Cloud 时请特别注意以下实例名限制只能包含拉丁字母数字字符或-不能以-开头也不能包含连续双连字符--实例名最大长度为 61 字符减去你的组织名长度即组织名长度 实例名长度必须小于 62 字符。创建示例gel instance create my-org/my-instanceGel Cloud 专属选项选项说明--regionregion实例所在区域可选aws-us-west-2、aws-us-east-2、aws-eu-west-1--tiertier云实例订阅层级可选pro和free--compute-sizenumber分配给云实例的计算资源大小以 Compute Units 计--storage-sizeGiB分配给云实例的存储大小以 GiB 计综合示例创建一个位于美西、pro 层级、2 个 Compute Unit、10 GiB 存储的云实例gel instance create --regionaws-us-west-2 --tierpro \ --compute-size2 --storage-size10 my-org/demo创建后的验证与管理创建成功后推荐依次执行# 查看凭据文件内容含连接信息 gel instance credentials demoxy # 查看实例运行状态 gel instance status demoxy # 列出所有实例 gel instance list # 停止实例 gel instance stop demoxy # 彻底销毁实例 gel instance destroy demoxy相关命令可参考同目录下的 gel_instance_credentials、gel_instance_status、gel_instance_destroy 等文档。与周边命令的配合gel instance create是实例生命周期管理的入口通常与以下命令配合使用启动/停止gel instance start/gel instance stop配合--start-confmanual手动管理实例生命周期凭据管理gel instance credentials查看或导出连接凭据升级gel instance upgrade在需要升级服务器版本时使用版本查询gel server list versions查看可用服务器版本以配合--version使用。完整的实例相关命令列表见 gel instance 目录索引。常见问题与注意事项自托管实例不要用instance create该命令面向 CLI 管理的本地/Cloud 实例自托管场景请参考 部署指南。Cloud 命名严格务必遵守 61 字符上限与“组织名长度 实例名长度 62”的约束且不能以-开头、不能含--。版本锁定记得加不加等号只会安装指定主版本的最新版加等号才是精确安装。默认端口是随机的如果需要固定端口请显式传入--port。shell 转义问题ZSH 等 shell 下使用前缀版本时注意转义或加引号。以上即gel instance create的完整使用说明覆盖本地与 Cloud 两大场景的全部参数与限制。更多细节可查阅 CLI 文档目录。赞分享数据库图数据库关系型数据库【免费下载链接】edgedbGel supercharges Postgres with a modern data model, graph queries, Auth AI solutions, and much more.项目地址https://gitcode.com/gh_mirrors/ed/edgedb点击查看免费下载相关推荐Gel 项目gel project完全指南项目初始化、实例关联与升级实战Gel 项目gel project完全指南项目初始化、实例关联与升级实战 gel project 是 Gel CLI 提供的一组项目管理命令用于把一个代数据库图数据库关系型数据库ty 类型检查器如何精确建模 sys.version_info字面量比较、字段访问与实现细节全解析ty 类型检查器如何精确建模 sys.version_info 字面量比较、字段访问与实现细节全解析 导读 sys.version_info 是 Python数据库图数据库关系型数据库RustFS 反向代理部署指南Caddy / Nginx / Cloudflare 前置下的 keep-alive 超时与 SigV4 转发故障排查RustFS 反向代理部署指南Caddy / Nginx / Cloudflare 前置下的 keep alive 超时与 SigV4 转发故障排查 本篇技术数据库图数据库关系型数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考