View Javadoc
1   /*
2    * #%L
3    * wcm.io
4    * %%
5    * Copyright (C) 2017 wcm.io
6    * %%
7    * Licensed under the Apache License, Version 2.0 (the "License");
8    * you may not use this file except in compliance with the License.
9    * You may obtain a copy of the License at
10   *
11   *      http://www.apache.org/licenses/LICENSE-2.0
12   *
13   * Unless required by applicable law or agreed to in writing, software
14   * distributed under the License is distributed on an "AS IS" BASIS,
15   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16   * See the License for the specific language governing permissions and
17   * limitations under the License.
18   * #L%
19   */
20  package io.wcm.devops.conga.plugins.aem.maven;
21  
22  import static io.wcm.tooling.commons.packmgr.install.VendorInstallerFactory.COMPOSUM_URL;
23  import static io.wcm.tooling.commons.packmgr.install.VendorInstallerFactory.CRX_URL;
24  
25  import java.util.List;
26  
27  import org.apache.commons.lang3.StringUtils;
28  import org.apache.maven.execution.MavenSession;
29  import org.apache.maven.plugin.AbstractMojo;
30  import org.apache.maven.plugin.MojoExecutionException;
31  import org.apache.maven.plugins.annotations.Component;
32  import org.apache.maven.plugins.annotations.Parameter;
33  import org.apache.maven.settings.crypto.SettingsDecrypter;
34  
35  import io.wcm.tooling.commons.packmgr.PackageManagerProperties;
36  import io.wcm.tooling.commons.packmgr.install.VendorInstallerFactory;
37  import io.wcm.tooling.commons.packmgr.install.VendorInstallerFactory.Service;
38  
39  /**
40   * Common functionality for all mojos.
41   */
42  abstract class AbstractContentPackageMojo extends AbstractMojo {
43  
44    private static final String CONSOLE_URL = "/system/console";
45  
46    /**
47     * <p>
48     * The URL of the HTTP service API of the CRX package manager.
49     * </p>
50     * <p>
51     * See <a href=
52     * "http://dev.day.com/docs/en/crx/current/how_to/package_manager.html#Managing%20Packages%20on%20the%20Command%20Line"
53     * >CRX HTTP service Interface</a> for details on this interface.
54     * </p>
55     */
56    @Parameter(property = "vault.serviceURL", required = true, defaultValue = "http://localhost:4502/crx/packmgr/service")
57    private String serviceURL;
58  
59    /**
60     * The user name to authenticate as against the remote CRX system (package manager).
61     */
62    @Parameter(property = "vault.userId", defaultValue = "admin")
63    private String userId;
64  
65    /**
66     * The password to authenticate against the remote CRX system (package manager).
67     */
68    @Parameter(property = "vault.password", defaultValue = "admin")
69    private String password;
70  
71    /**
72     * OAuth 2 access token to authenticate against the remote CRX system (package manager).
73     * If this is configured, username and password are ignored.
74     */
75    @Parameter(property = "vault.oauth2AccessToken")
76    private String oauth2AccessToken;
77  
78    /**
79     * The user name to authenticate as against the remote CRX system (Felix console).
80     * Defaults to the value from <code>userId</code>.
81     */
82    @Parameter(property = "console.userId")
83    private String consoleUserId;
84  
85    /**
86     * The password to authenticate against the remote CRX system (Felix console).
87     * Defaults to the value from <code>password</code>.
88     */
89    @Parameter(property = "console.password")
90  
91    private String consolePassword;
92    /**
93     * OAuth 2 access token to authenticate against the remote CRX system (Felix console).
94     * If this is configured, username and password are ignored.
95     * Defaults to value from <code>authenticationBearerToken</code>.
96     */
97    @Parameter(property = "console.consoleOauth2AccessToken")
98    private String consoleOauth2AccessToken;
99  
100   /**
101    * Set this to "true" to skip installing packages to CRX although configured in the POM.
102    */
103   @Parameter(property = "vault.skip", defaultValue = "false")
104   private boolean skip;
105 
106   /**
107    * Number of times to retry upload and install via CRX HTTP interface if it fails.
108    */
109   @Parameter(property = "vault.retryCount", defaultValue = "24")
110   private int retryCount;
111 
112   /**
113    * Number of seconds between retry attempts.
114    */
115   @Parameter(property = "vault.retryDelay", defaultValue = "5")
116   private int retryDelay;
117 
118   /**
119    * <p>
120    * Bundle status JSON URL. If an URL is configured the activation status of all bundles in the system is checked
121    * before it is tried to upload and install a new package and after each upload.
122    * </p>
123    * <p>
124    * If not all bundles are activated the upload is delayed up to {@link #bundleStatusWaitLimit} seconds,
125    * every 5 seconds the activation status is checked anew.
126    * </p>
127    * <p>
128    * Expected is an URL like: http://localhost:4502/system/console/bundles/.json
129    * </p>
130    * <p>
131    * If the URL is not set it is derived from serviceURL. If set to "-" the status check is disabled.
132    * </p>
133    */
134   @Parameter(property = "vault.bundleStatusURL", required = false)
135   private String bundleStatusURL;
136 
137   /**
138    * Number of seconds to wait as maximum for a positive bundle status check.
139    * If this limit is reached and the bundle status is still not positive the install of the package proceeds anyway.
140    */
141   @Parameter(property = "vault.bundleStatusWaitLimit", defaultValue = "360")
142   private int bundleStatusWaitLimit;
143 
144   /**
145    * <p>
146    * Package Manager install status JSON URL. If an URL is configured the installation status of packages and
147    * embedded packages is checked before it is tried to upload and install a new package and after each upload.
148    * </p>
149    * <p>
150    * If not all packages are installed the upload is delayed up to {@link #packageManagerInstallStatusWaitLimit}
151    * seconds, every 5 seconds the installation status is checked anew.
152    * </p>
153    * <p>
154    * Expected is an URL like: http://localhost:4502/crx/packmgr/installstatus.jsp
155    * </p>
156    * <p>
157    * If the URL is not set it is derived from serviceURL. If set to "-" the status check is disabled.
158    * </p>
159    */
160   @Parameter(property = "vault.packageManagerInstallStatusURL", required = false)
161   private String packageManagerInstallStatusURL;
162 
163   /**
164    * Number of seconds to wait as maximum for a positive package manager install status check.
165    * If this limit is reached and the package manager status is still not positive the install of the package proceeds
166    * anyway.
167    */
168   @Parameter(property = "vault.packageManagerInstallStatusWaitLimit", defaultValue = "360")
169   private int packageManagerInstallStatusWaitLimit;
170 
171   /**
172    * Patterns for symbolic names of bundles that are expected to be not present in bundle list.
173    * If any of these bundles are found in the bundle list, this system is assumed as not ready for installing further
174    * packages because a previous installation (e.g. of AEM service pack) is still in progress.
175    */
176   @Parameter(property = "vault.bundleStatusBlacklistBundleNames", defaultValue = "^updater\\.aem.*$")
177   private String[] bundleStatusBlacklistBundleNames;
178 
179   /**
180    * Patterns for symbolic names of bundles that are ignored in bundle list.
181    * The state of these bundles has no effect on the bundle status check.
182    */
183   @Parameter(property = "vault.bundleStatusWhitelistBundleNames",
184       defaultValue = "^com\\.day\\.crx\\.crxde-support$,"
185           + "^com\\.adobe\\.granite\\.crx-explorer$,"
186           + "^com\\.adobe\\.granite\\.crxde-lite$,"
187           + "^org\\.apache\\.sling\\.jcr\\.webdav$,"
188           + "^org\\.apache\\.sling\\.jcr\\.davex$")
189   private String[] bundleStatusWhitelistBundleNames;
190 
191   /**
192    * If set to true also self-signed certificates are accepted.
193    */
194   @Parameter(property = "vault.relaxedSSLCheck", defaultValue = "false")
195   private boolean relaxedSSLCheck;
196 
197   /**
198    * HTTP connection timeout (in seconds).
199    */
200   @Parameter(property = "vault.httpConnectTimeoutSec", defaultValue = "10")
201   private int httpConnectTimeoutSec;
202 
203   /**
204    * HTTP socket timeout (in seconds).
205    */
206   @Parameter(property = "vault.httpSocketTimeoutSec", defaultValue = "60")
207   private int httpSocketTimeout;
208 
209   /**
210    * Log level to be used to log responses from package manager (which may get huge for large packages).
211    * Possible values are INFO (default) or DEBUG.
212    */
213   @Parameter(property = "vault.packageManagerOutputLogLevel", defaultValue = "INFO")
214   private String packageManagerOutputLogLevel;
215 
216   @Parameter(property = "session", defaultValue = "${session}", readonly = true)
217   private MavenSession session;
218 
219   @Component(role = SettingsDecrypter.class)
220   private SettingsDecrypter decrypter;
221 
222   protected final boolean isSkip() {
223     return this.skip;
224   }
225 
226   protected PackageManagerProperties getPackageManagerProperties() throws MojoExecutionException {
227     PackageManagerProperties props = new PackageManagerProperties();
228 
229     props.setPackageManagerUrl(buildPackageManagerUrl());
230     props.setUserId(this.userId);
231     props.setPassword(this.password);
232     props.setOAuth2AccessToken(this.oauth2AccessToken);
233     props.setConsoleUserId(this.consoleUserId);
234     props.setConsolePassword(this.consolePassword);
235     props.setConsoleOAuth2AccessToken(this.consoleOauth2AccessToken);
236     props.setRetryCount(this.retryCount);
237     props.setRetryDelaySec(this.retryDelay);
238     props.setBundleStatusUrl(buildBundleStatusUrl());
239     props.setBundleStatusWaitLimitSec(this.bundleStatusWaitLimit);
240     props.setBundleStatusBlacklistBundleNames(List.of(this.bundleStatusBlacklistBundleNames));
241     props.setBundleStatusWhitelistBundleNames(List.of(this.bundleStatusWhitelistBundleNames));
242     props.setPackageManagerInstallStatusURL(buildPackageManagerInstallStatusUrl());
243     props.setPackageManagerInstallStatusWaitLimitSec(this.packageManagerInstallStatusWaitLimit);
244     props.setRelaxedSSLCheck(this.relaxedSSLCheck);
245     props.setHttpConnectTimeoutSec(this.httpConnectTimeoutSec);
246     props.setHttpSocketTimeoutSec(this.httpSocketTimeout);
247     props.setProxies(ProxySupport.getMavenProxies(session, decrypter));
248     props.setPackageManagerOutputLogLevel(this.packageManagerOutputLogLevel);
249 
250     return props;
251   }
252 
253   private String buildPackageManagerUrl() throws MojoExecutionException {
254     String serviceUrl = this.serviceURL;
255     switch (VendorInstallerFactory.identify(serviceUrl)) {
256       case CRX:
257         serviceUrl = VendorInstallerFactory.getBaseUrl(serviceUrl) + CRX_URL;
258         break;
259       case COMPOSUM:
260         serviceUrl = VendorInstallerFactory.getBaseUrl(serviceUrl) + COMPOSUM_URL;
261         break;
262       default:
263         throw new MojoExecutionException("Unsupported service URL: " + serviceUrl);
264     }
265     return serviceUrl;
266   }
267 
268   private String buildBundleStatusUrl() throws MojoExecutionException {
269     if (StringUtils.equals(this.bundleStatusURL, "-")) {
270       return null;
271     }
272     if (this.bundleStatusURL != null) {
273       return this.bundleStatusURL;
274     }
275     // if not set use hostname from serviceURL and add default path to bundle status
276     String baseUrl = VendorInstallerFactory.getBaseUrl(buildPackageManagerUrl());
277     return baseUrl + "/system/console/bundles/.json";
278   }
279 
280   private String buildPackageManagerInstallStatusUrl() throws MojoExecutionException {
281     if (StringUtils.equals(this.packageManagerInstallStatusURL, "-")
282         || VendorInstallerFactory.identify(this.serviceURL) != Service.CRX) {
283       return null;
284     }
285     if (this.packageManagerInstallStatusURL != null) {
286       return this.packageManagerInstallStatusURL;
287     }
288     // if not set use hostname from serviceURL and add default path to bundle status
289     String baseUrl = VendorInstallerFactory.getBaseUrl(buildPackageManagerUrl());
290     return baseUrl + "/crx/packmgr/installstatus.jsp";
291   }
292 
293   protected String buildConsoleUrl() {
294     return VendorInstallerFactory.getBaseUrl(this.serviceURL) + CONSOLE_URL;
295   }
296 
297   protected String getConsoleUser() {
298     return this.consoleUserId;
299   }
300 
301   protected String getConsolePassword() {
302     return this.consolePassword;
303   }
304 
305 }