README

SGControlBundle是一个提供与ServerGrove控制面板交互的命令行工具的Symfony2 bundle。它还提供了一个交互式shell。

以下命令行工具提供

• API客户端命令行界面

API客户端CLI允许通过HTTP API连接到ServerGrove控制面板。要连接到API，您需要成为有访问控制面板和API的注册客户，并且需要在用户配置文件中启用API访问。

安装

下载或克隆bundle。如果您使用deps文件，请按如下方式添加

[SGControlBundle]
	git=git://github.com/servergrove/SGControlBundle.git
	target=/bundles/ServerGrove/Bundle/SGControlBundle

将ServerGrove命名空间添加到app/autoload.php

$loader->registerNamespaces(array(
	...
	'ServerGrove' => __DIR__.'/../vendor/bundles',
	...
));

在app/AppKernel.php中启用它

public function registerBundles()
{
	$bundles = array(
		...

		new ServerGrove\Bundle\SGControlBundle\SGControlBundle(),
	);

	...
}

配置

默认情况下，API客户端将使用我们的演示API密钥/密钥组合。这仅允许您对服务器运行一些测试，但不会允许您访问您的账户和服务器。

您需要在https://control.servergrove.com/profile中用户配置文件中启用API访问

一旦您有了API密钥和密钥，请将其添加到app/config.yml

parameters:
	sgc_api.client.apiKey: your-key
	sgc_api.client.apiSecret: your-secret

使用

./console sg:api:client call [args]

• call: 由命名空间和操作组成的调用（例如。server/list）
• args: （可选）要发送到调用的变量列表（例如。serverId=abc123&isActive=0）

示例

./console sg:api:client test/version
./console sg:api:client server/list
./console sg:api:client server/stop serverId=abc123

交互式shell

./console sg:shell

命令

• help/h/? - 列出命令
• servers - 列出服务器
• server [选项] - 从服务器列表中选择一个服务器。选项可以是列表中的数字选项或服务器名称。也可以提供部分名称，它将选择第一个匹配项
• exec cmd - 在所选服务器上执行命令
• reboot [服务器] - 重启服务器。[服务器]是可选的。如果没有给出，它将使用所选服务器。在进行之前会要求确认
• shutdown [服务器] - 关闭服务器。[服务器]是可选的。如果没有给出，它将使用所选服务器。在进行之前会要求确认
• bootup [服务器] - 启动服务器。[服务器]是可选的。如果没有给出，它将使用所选服务器
• discover [服务器] - 向服务器发送发现请求。发现请求将更新服务器和应用程序信息。[服务器]是可选的。如果没有给出，它将使用所选服务器。
• domains - 列出所选服务器下的域名
• domain [选项] - 从域名列表中选择一个域名。选项可以是列表中的数字选项或域名名称。也可以提供部分名称，它将选择第一个匹配项
• apps - 列出所选服务器下的应用程序
• app [选项] - 从应用程序列表中选择一个应用程序。选项可以是列表中的数字选项或应用程序名称。也可以提供部分名称，它将选择第一个匹配项
• restart [应用程序] - 重新启动应用程序。[应用程序]是可选的。如果没有给出，它将使用所选应用程序。在进行之前会要求确认
• stop [应用程序] - 停止应用程序。[应用程序]是可选的。如果没有给出，它将使用所选应用程序。在进行之前会要求确认
• start [应用程序] - 启动应用程序。[应用程序]是可选的。如果没有给出，它将使用所选应用程序
• 运行最后一个命令
• x/q - 重置内部选择
• 退出/quit - 退出shell

警告

注意： API仍在积极开发中，因此事物可能会发生变化。请留意这一点。

更多信息

• 可用API调用和参数列表
• ServerGrove网站
• ServerGrove博客
• ServerGrove控制面板
• ServerGrove知识库
• 关注ServerGrove @ Twitter
• GitHub下载