附註：

使用 OCI Functions 和 Python 在 Jira Service Management 中開啟票證

簡介

下列教學課程適用於使用 OCI Monitoring 服務和 Jira Service Management 開啟票證和追蹤事件的 Oracle Cloud Infrastructure (OCI) 使用者。假設您有一個 OCI 執行處理，而且想要知道執行處理因某些錯誤而意外停止運作的時間。您想要收到通知並立即在 Jira Service Management 中開啟回報項目，讓上班工程師可以盡快開始調查並修正問題。使用 OCI Functions 服務時，在偵測到組織系統有問題時，可以在 Jira Service Management 中自動開啟票證。

目標

必要條件

作業 1：建立虛擬雲端網路

虛擬雲端網路 (VCN) 是您在 OCI 中定義的網路。它包括子網路、路由表和閘道。

  1. 按一下靠近 OCI 主控台左上角的服務功能表 服務功能表。

  2. 在網路下，選取虛擬雲端網路。

  3. 在虛擬雲端網路頁面中，按一下啟動 VCN 精靈。

  4. 選取建立具有網際網路連線的 VCN ，然後按一下啟動 VCN 精靈。

  5. 完成 VCN 組態，按一下下一步並建立。

作業 2：建立動態群組

動態群組可讓您將 OCI Compute 執行處理群組為主要動作者 (類似使用者群組)。

注意：您需要「管理員」權限才能建立動態群組。

  1. 從服務功能表中，瀏覽至識別與安全性、識別，然後按一下動態群組。

  2. 按一下建立動態群組。

  3. 輸入有意義的名稱和描述。

  4. 在規則 1 區段中，新增下列行：

    ALL {resource.type = 'fnfunc', resource.compartment.id = 'ocid1.compartment.oc1', instance.compartment.id = 'ocid1.compartment.oc1'}

    注意：請以您想要的區間 ID 取代區間 ID。

  5. 按一下建立。

作業 3：建立 OCI IAM 原則

Oracle Cloud Infrastructure Identity and Access Management (OCI IAM) 可讓您控制可存取雲端資源的人員。為了使此整合運作，我們需要將「函數即服務」(FaaS) 服務 (功能服務) 的存取權授予 Vault、儲存庫及數個其他服務。

  1. 從服務功能表中，瀏覽至識別與安全性、識別，然後按一下原則。

  2. 按一下建立原則。

  3. 輸入適當的名稱和描述，並確定選擇正確的區間 (在此範例中，我們將使用名為 DEV 的區間)。

  4. 在 Policy Builder 區段中，確定啟用顯示手動編輯器並新增下列行：

    Allow service faas to read repos in tenancy

Allow service faas to read secret-family in compartment DEV

Allow service faas to read vaults in compartment DEV

Allow service faas to use keys in compartment DEV

Allow service faas to use apm-domains in compartment DEV

Allow dynamic-group DGNAME to read secret-family in compartment DEV

Allow dynamic-group DGNAME to read vaults in compartment DEV

Allow dynamic-group DGNAME to use keys in compartment DEV

    注意：請將動態群組 (DGNAME) 名稱和區間 (DEV) 名稱取代為想要的名稱。

  5. 按一下建立。

作業 4：建立儲存庫以儲存功能

OCI Container Registry 可讓您在 Oracle 管理的登錄中儲存、共用及管理容器映像檔 (例如 Docker 映像檔)。

  1. 移至 OCI 主控台，開啟服務功能表，然後按一下開發人員服務。在容器底下，按一下容器登錄。

  2. 按一下建立儲存區域。

  3. 在建立儲存區域對話方塊中，指定您選擇的區間和儲存區域名稱，並將它保留為專用。

  4. 按一下建立儲存區域。

作業 5：建立保存庫以儲存 Jira Service Management 登入的使用者和 API 權杖

Oracle Cloud Infrastructure Vault 是一項金鑰管理服務，可儲存及管理主要加密金鑰和密碼，以提供安全的資源存取。

  1. 開啟服務功能表，按一下識別與安全 (Identity & Security) 和保存庫 (Vault) 。

  2. 按一下建立保存庫。

  3. 在建立保存庫對話方塊中，選取您選擇的區間，然後輸入您選擇的適當名稱。您也可以選擇是否要將它設為專用。

    注意： Vault 建立後，您無法變更 Vault 類型。

  4. 完成之後，請按一下建立保存庫。

    注意：將 Jira Service Management api-token 和 api-user 分別儲存在保存庫中。

作業 6：建立應用模組

  1. 開啟服務功能表，然後按一下開發人員服務。在函數下，按一下應用程式。

  2. 按一下建立應用程式。

  3. 在建立應用程式視窗中，輸入應用程式的名稱 (例如 Jira-Ticketing)，選取在工作 1 中建立的 VCN，然後選取公用子網路。

  4. 按一下建立。

作業 7：部署函數

此作業將使用可從「先決條件」區段下載的壓縮存檔。

  1. 從清單中選取工作 6 中新建立的應用程式。

  2. 在應用程式視窗中，遵循資源下開始使用選項中可用的步驟。

    注意：

    • 本教學課程使用 OCI Cloud Shell 設定。

    • 在設定的步驟 4 中，請確定指定在工作 4 中建立的儲存區域名稱。

  3. 按一下啟動 Cloud Shell 之後，頁面底端就會顯示一個新的小型 Shell 視窗。在該視窗的右上角，按一下齒輪功能表，然後選取上傳

  4. 拖放將在本位目錄中上傳的 jsm-ticket-function.zip 檔案。

  5. 使用下列指令將歸檔解壓縮。

    unzip jsm-ticket-function.zip

  6. 使用 cd jsm-ticket-function 命令切換至函數目錄，然後繼續執行 OCI 主控台中所述的步驟。

作業 8：編輯功能組態

這些函數具有一些可設定的參數，必須加以編輯，才能正常運作。

  1. 在 OCI 主控台中，前往在工作 6 中建立的應用程式，然後從資源底下的左側選取函數。

  2. 按一下函數 jsm-ticket-function 的名稱。

  3. 按一下資源下方的組態。您將可以看到五個金鑰：api-token、api-user、service_desk_id、request_type_id 和 vault_ocid。

    所有這些金鑰都必須透過您的組態進行編輯：

    • api-token：保存庫中儲存回報項目所建立之使用者帳戶的 API 記號的加密密碼名稱。如需詳細資訊，請參閱管理 Atlassian 帳戶的 API 權杖。

    • api-user：保存庫的加密密碼名稱是代表儲存回報項目建立之使用者的電子郵件地址。

    • service_desk_id：將建立票證的專案。

    • request_type_id：將建立回報項目的要求類型 (這必須要有標題和描述)。

    • vault_ocid：vault_ocid，其中儲存 API 記號和 API 使用者加密密碼。

    取得 service_desk_id 和 request_type_id 的快速簡易方式就是造訪您要使用的入口網站，並查看 URL。例如，移至入口網站，然後按一下提出的要求，您就會看到如下的 URL：https://somewhere.atlassian.net/servicedesk/customer/portal/10/group/229/create/664

    其中的數字為：

    • 10：入口網站 / 服務人員。
    • 229：要求的群組來自 (僅供導覽使用，您並不關心 REST 中的群組)。
    • 664：我點選之要求類型的 ID。

工作 9：訂閱主題的功能

  1. 開啟服務功能表，然後按一下開發人員服務。在應用程式整合下，按一下通知。

    注意：請務必位於正確的區間中。

  2. 按一下建立主題。

  3. 輸入適當的名稱，然後按一下建立。

  4. 建立主題之後，請從主題清單中選取主題。

  5. 在主題視窗中，從資源底下的左側選取訂閱，然後按一下建立訂閱。

  6. 在建立訂閱視窗中，選取要函數的協定，選取區間、應用程式以及在工作 6 中建立的函數。

  7. 按一下建立。

作業 10：為需要監控的度量建立警示

您可以建立多種類型的警示。在本教程中，我們選擇了缺勤警報。

  1. 開啟服務功能表，然後按一下可觀測性與管理。在監控下，按一下警報定義。

  2. 按一下建立警示。

  3. 在建立警示頁面的定義警示下，輸入或更新警示設定值。

  4. 在定義警示通知下，確定選取在工作 9 中建立的主題。

  5. 選取訊息格式作為傳送 Pretty JSON 訊息 (含換行符號的原始文字) 。

  6. 按一下儲存警示。

認可

其他學習資源

探索 docs.oracle.com/learn 上的其他實驗室，或存取 Oracle Learning YouTube 頻道上的更多免費學習內容。此外，請造訪 education.oracle.com/learning-explorer 以成為 Oracle Learning Explorer。

如需產品文件，請造訪 Oracle Help Center 。