应用程序服务

---

管理服务（用户）

---

管理服务（用户）服务利用角色提供管理功能。用户角色是具备若干验证凭据的实体。一般情况下，用户角色用于验证一个动作的发起方。用户角色包括：
• 具有用户名和密码的人类用户。
• 具有主机名和SSL证书的机器。
管理服务（用户）服务在Predix机器网络控制台内提供。

管理用户

启动您的Predix机器调试容器，打开Predix机器网络控制台。
要修改管理员用户的默认用户名和密码，网络控制台需要管理组登录用户。您可以在网络控制台内新增用户或修改密码：https://localhost:8443/system/console/bundles。默认的 management-impl 组件（bundle）捆绑束实现在启动时创建下列用户： 用户名：predix密码：predix2machine组：administration。
注：
您可以通过下列操作使用自己的用户名和密码：将容器内的 management-impl 替换为实现 com.prosyst.mbs.services.useradmin.SimpleLogin 接口的自定义版本。
1. 打开https://localhost:8443/system/console/bundles。
2. 在Predix菜单内点击用户管理创建用户。
3. 执行下列操作：
o 添加用户。
a. 点击加号（+）图标。
出现创建用户对话框。
b. 在用户名框内输入新用户名。
c. 在密码框内输入新密码。
d. 在确认密码框内重新输入密码。
e. 点击创建用户。
用户出现在用户列表内。
o 修改用户密码。
a. 在用户列表内点击用户名。
b. 在原密码框内输入原密码。
c. 在新密码框内输入新密码。
d. 在确认密码框内重新输入密码。
e. 点击修改密码。
o 删除用户。
a. 在用户列表内点击用户名。
b. 点击用户名旁边的删除图标。
c. 在确认删除对话框内点击删除用户。
用户从用户列表中移除。

使用管理组件捆绑束（bundle）示例应用程序

提供管理组件（bundle）捆绑束示例应用程序的目的是示范如何使用此服务。
1. 导航至/samples/sample-apps.zip，解压文件。
2. 在sample-apps/sample文件夹内，打开sample-management应用程序。
注：
关于构建和运行示例应用程序的说明参见在Predix SDK内构建示例和运行示例。

Git存储库管理服务

IGitRepository helper 接口会在启动时克隆一个存储库或打开一个现有存储库，然后提供简单的Git命令，如：clean, reset, pull和push。通过API，可以访问Git对象和安全提供者，提交文件，还可以访问更高级的特性。配置文件在Git存储库内管理。
获得JGit示例代码
如需JGit Java Git实现示例和代码片段，请点击以下链接：
https://github.com/centic9/jgit-cookbook
如要下载JGit的Javadoc，请点击以下链接：
http://download.eclipse.org/jgit/docs/latest/apidocs/
如要下载Git存储库的公共GUI，请点击以下链接：
http://git-scm.com/downloads/guis
如要访问Git命令行文档，请点击以下链接：
http://www.kernel.org/pub/software/scm/git/docs/
如要从Eclipse内访问本地或远程存储库，从Eclipse内安装新软件，添加Git支持或添加URL：
http://download.eclipse.org/egit/updates
使用Git存储库APIs
查看Git存储库Javadoc API，了解如何实现Git存储库。
1. 导航至下列文件，将压缩包内的所有文件解压：/docs/apidocs.zip
2. 找到并打开下列API：/docs/apidocs/index.html/com.ge.dspmicro.gitrepository.api.

使用Git存储库示例应用程序

提供Git存储库示例应用的目的是示范如何使用此服务。
1. 导航至/samples/sample-apps.zip，解压文件。
2. 找到并打开/sample-apps/sample/sample-gitrepository。
注：
关于构建和运行示例应用程序的说明参见在Predix SDK内构建示例和运行示例。
配置Git存储库管理服务
安全权限默认只允许JGit在/appdata/GitRepositories内创建存储库。
如果配置文件属性设置为暴露帮助（helper）功能，则在REST下提供此功能。此属性为com.ge.dspmicro.gitrepository.rest.enabled=true。可以从服务器为这些选项返回一个简单的HTML页面：http://localhost:8181/git.api/v1/commands
IGitRepository 是一个单例模式服务。使用 IGitRepository 服务的所有应用程序共享一个实例。此服务提供了一种简单的方法，用于访问配置文件内的默认Git存储库设置。
格式化.config文件（不是.cfg文件）内的属性值时，使用类型字符，后跟引用的值字符串表示。例如，一个布尔型属性=B”true”。小写类型字符表示基本数据。字符串的类型可以省略。下表列出了类型和对应的类型字符：

数组格式为属性=<类型>[”<值1>”,”<值2>”]。例如，整型数组属性=I[“1”, “2”, “3”].清晰起见，可使用反斜杠分隔。
1. 找到并打开下列文件/configuration/machine /com.ge.dspmicro.gitrepository.config。
2. 设置以下属性的值，在首次访问时克隆一个远程存储库：

---

属性： com.ge.dspmicro.gitrepository.clone.uri
描述： 首次访问时克隆远程存储库。设置此属性以在启动时克隆远程存储库。克隆完成后，使用服务命令pull、push或reset本地存储库。
例如： https://anonymous@openge.ge.com/git/gumf
默认值：-

---

属性： com.ge.dspmicro.gitrepository.clone.path
描述： 本地gitRepositories文件夹内存储克隆存储库的文件夹名称。如果未指定此属性，则使用克隆URI的路径名； 如果没有路径，则使用 default。
默认值： -

---

属性： com.ge.dspmicro.gitrepository.credentials.username
描述： 访问存储库时用于验证的用户名（如需验证）。
凭据也可以在URI中传递，方法是在地址前添加：
username:password@https://username:password@openge.ge.com/git/project
对于所有人都具有读权限的项目，可以使用匿名用户。这种情况下无需传递“凭据”。 https://anonymous@openge.ge.com/git/project
默认值： -

---

属性：com.ge.dspmicro.gitrepository.credentials.username
com.ge.dspmicro.gitrepository.credentials.password
描述：访问存储库时的验证密码。对密码进行了加密。
默认值：-

---

属性： com.ge.dspmicro.gitrepository.rest.enabled
描述： 如果默认存储库支持REST接口，布尔量- true表示启用，false表示不支持REST。
启用后，将返回含有命令的示例HTML页面：
https://{hostname}:{port}/git.api/v1/commands
默认值： B”false”

---