程式碼品質測試 code-quality-testing

了解管道程式碼品質測試如何運作及如何提高部署品質。

簡介 introduction

程式碼品質測試根據一組品質規則評估您的應用程式程式碼。這是程式碼品質管道的主要目的，並在所有生產和非生產管道中的建構步驟之後立即執行。

請參閱設定 CI-CD 管道，深入了解不同類型管道。

程式碼品質規則 understanding-code-quality-rules

程式碼品質測試會掃描原始程式碼以確保其符合特定的品質標準。這是透過 SonarQube 和使用 OakPAL 的內容包級別檢查的組合來實現的。有超過 100 條規則結合了通用 Java 規則和 AEM 特定規則。部分 AEM 特定規則是根據 AEM 工程團隊的最佳做法建立的，並被稱為自訂程式碼品質規則。

三層級評等 three-tiered-gate

程式碼品質測試確定的問題被指派到三個類別之一。

評等 ratings

此步驟的結果交付為​ 評級。

下表總結了各關鍵、重要和資訊類別的評級和故障閾值。

處理誤判 dealing-with-false-positives

品質掃描流程並非完美無瑕，有時會錯誤地識別出實際上不構成問題的問題。這即稱為​ 誤判。

在這些情況下，可以使用標準 Java @SuppressWarnings 註解來標註原始程式碼，將規則 ID 指定為註解屬性。例如，一種常見的誤判是用於偵測硬式編碼密碼的 SonarQube 規則可能對如何識別硬式編碼密碼過於積極。

以下程式碼在 AEM 專案中相當常見，其中包含連接到某些外部服務的程式碼。

@Property(label = "Service Password")
private static final String PROP_SERVICE_PASSWORD = "password";

SonarQube 因此會提出阻斷式漏洞。但在查看程式碼後，您會發現這並非漏洞，然後可以使用適當的規則 ID 標註程式碼。

@SuppressWarnings("squid:S2068")
@Property(label = "Service Password")
private static final String PROP_SERVICE_PASSWORD = "password";

但如果程式碼確實有此問題：

@Property(label = "Service Password", value = "mysecretpassword")
private static final String PROP_SERVICE_PASSWORD = "password";

則正確的解決方案是移除硬式編碼的密碼。

掃描最佳化的內容套件 content-package-scanning-optimization

在品質分析流程中，Cloud Manager 會對 Maven 組建產生的內容套件進行分析。Cloud Manager 可提供最佳化功能以加速此流程，若需遵守某些套件限制，前述功能即有助益。最顯著的是針對輸出單一內容套件（通常稱為「全」套件）的專案執行的最佳化，該套件包含由組建產生的數個其他內容套件（這些內容套件標籤為已略過）。 當 Cloud Manager 偵測到這種情況時，會直接掃描個別內容套件並根據相依性進行排序，而不是將「全」套件解除封裝。例如，考慮以下組建輸出。

如果 myco-all-1.0.0-SNAPSHOT.zip 內的項目只有兩個已略過的內容套件，則掃描這兩個嵌入的套件而不是「所有」內容套件。

對於產生數十個嵌入套件的專案，已證明這種最佳化將在每次管道執行節省 10 分鐘以上的時間。

當「全」內容套件包含已略過的內容套件和 OSGi 套裝的組合時，可能會出現一種特殊情況。例如，如果 myco-all-1.0.0-SNAPSHOT.zip 包含前面提到的兩個嵌入套件以及一個或多個 OSGi 套裝，則會建構出一個全新、最小的內容套件，且僅包含 OSGI 套裝。此套件一律名為 cloudmanager-synthetic-jar-package，而且會將所包含的套裝放在 /apps/cloudmanager-synthetic-installer/install 中。