應用程式服務

管理服務（使用者）

管理服務（使用者）服務利用角色提供管理功能。使用者角色是具備若幹驗證憑據的實體。一般情況下，使用者角色用于驗證一個動作的發起方。使用者角色包括：

• 具有使用者名和密碼的人類使用者。

• 具有主機名和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://[email protected]/git/gumf

預設值：-

屬性： com.ge.dspmicro.gitrepository.clone.path

描述： 本地gitRepositories檔案夾記憶體儲克隆存儲庫的檔案夾名稱。如果未指定此屬性，則使用克隆URI的路徑名； 如果沒有路徑，則使用 default。

預設值： -

屬性： com.ge.dspmicro.gitrepository.credentials.username

描述： 通路存儲庫時用于驗證的使用者名（如需驗證）。

憑據也可以在URI中傳遞，方法是在位址前添加：

username:password@https://username:[email protected]/git/project

對于所有人都具有讀權限的項目，可以使用匿名使用者。這種情況下無需傳遞“憑據”。 https://[email protected]/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”