返回 登录
0

应用程序服务

阅读32288

管理服务(用户)


管理服务(用户)服务利用角色提供管理功能。用户角色是具备若干验证凭据的实体。一般情况下,用户角色用于验证一个动作的发起方。用户角色包括:
• 具有用户名和密码的人类用户。
• 具有主机名和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”


评论