Talk @ AEM meetup hosted by Emakina Amsterdam

Manual actions are mindnumbing for developers all over the world. On top of that, developers want to automate about everything.

AEMAdmin started out of frustration of having to delete several nodes in the repository manually after every deploy on my localbox. I wanted an error-free 1-click operation. So I defined the steps just once and let the program run over and over again.

In the meantime, it kept on growing and it now is a fullblown library with all kind of actions for property, node and page manipulations, querying, and so on. All commands follow the same structure and when testing is finished, you can point it to a different environment to execute the same tasks in the same order.

In this talk, I'll tell about the story how it came to be and how real-life challenges made the project grow. So expect a lot of live action and maybe some deja-vus.

Transcript

1. NO MORE NO MORE MONKEYWORK MONKEYWORK WITH AEMADMIN WITH AEMADMIN Pieter-Jan Drouillon AEM Developer Meetup NL - May 8, 2018
2. ABOUT ME ABOUT ME Academic background Short-lived career in Supply Chain Full-stack developer @ Design Is Dead
3. WHY? WHY?
4. POINT & CLICK POINT & CLICK 1. Update property 2. Add node 3. Install content package
5. STUMBLED ON ... STUMBLED ON ...
6. FIRST ATTEMPT FIRST ATTEMPT
7. function createPage{ param([int]$port=4502,[string]$path,[string]$name,[string] if($deleteFirst){ deletePage -port $port -path $path -name $name } $cmd = 'curl.exe -u admin:admin -F"jcr:primaryType=cq:Page Invoke-Expression $cmd $cmd = 'curl.exe -u admin:admin -F"jcr:primaryType=cq:Page Invoke-Expression $cmd }
8. PROS / CONS PROS / CONS Lightweight Testable Easy & consistent syntax
9. WHY NOT JAVA? WHY NOT JAVA?
10. TESTABLE TESTABLE Junit & Mockito
11. LIGHTWEIGHT LIGHTWEIGHT Apache HttpClient, Commons Lang & com.github.tsohr:json
12. EASY & CONSISTENT EASY & CONSISTENT Naming convention & method chaining
13. EXAMPLES EXAMPLES
14. ADDING PROPERTIES ADDING PROPERTIES
15. CompositeCommand cc = new CompositeCommand(); //base website String[] base_languages = {"nl","fr","en"}; String[] base_segments = {"retail","soho","sme"}; for(String lang:base_languages){ for(String segment:base_segments){ String path = String.format("/content/kpngb-base/%s/%s SetPropertyCommand spc = new SetPropertyCommand(path," cc.add(spc); path = String.format("/content/kpngb-base/%s/%s/sales- spc = new SetPropertyCommand(path,"enableOnlineSales", cc.add(spc); } }
16. QUERY COMMAND QUERY COMMAND
17. public QueryCommand addCondition(String key,String value) public QueryCommand setHitLimit(int limit) public QueryCommand fullHit() public QueryCommand propertyExists(String prefix, String propertyName) public int getResults() public int getTotal() public boolean hasMore()
18. POSTPROCESS POSTPROCESS
19. /** * Queries return JSON with an array called hits. This method will pro * @param hit the result to process */ public abstract void postProcessOneResult(JSONObject hit);
20. DEFINE QUERY DEFINE QUERY public WorkflowInstancesQueryCommand(String status){ addCondition("path","/etc/workflow/instances/server0"); addCondition("p.hits","full"); addCondition("orderby","endTime"); if(status != null){ addCondition("1_property","status"); addCondition("1_value",status); } else{ propertyExists("1_","status"); } }
21. LOOP OVER HITS LOOP OVER HITS public class DifferentStatusValuesCommand extends QueryPostPro private Set<string> statuses; public DifferentStatusValuesCommand(WorkflowInstancesQuery super(command); statuses = new HashSet<>(); } @Override public void postProcessOneResult(JSONObject hit) { statuses.add(hit.getString("status")); } public Set<string> getStatuses() { return statuses; } }
22. INSTANCE INSTALL INSTANCE INSTALL
23. CompositeCommand cc = new CompositeCommand(); //Enable crx/de EnableCrxCommand ecc = new EnableCrxCommand(); cc.add(ecc); BulkPackageInstallCommand bpic = new BulkPackageInstallCommand //One off packages for a fresh install bpic.addPackage("D:\\packages_to_install\\acs-aem-commons-cont .addPackage("D:\\packages_to_install\\acs-aem-tools-content-0. .addPackage("D:\\packages_to_install\\AEM-6.3-Service-Pack-1-6 .addPackage("D:\\packages_to_install\\cq-6.3.0-hotfix-19148-1. .addPackage("D:\\packages_to_install\\Content_auth_PROD_CRQ000 .addPackage("D:\\packages_to_install\\Content_auth_PROD_CRQ000 .addPackage("D:\\packages_to_install\\permissions.zip") .addPackage("D:\\packages_to_install\\nprd_userGroups.zip"); //install the Java code
24. OTHER FEATURES OTHER FEATURES
25. Instance config via cmdline property fat jar
26. CONCLUSION CONCLUSION
27. Reduce point & click monkeywork Testable Lightweight Easy http://github.com/pieterjd/aemadmin
28. Q & A Q & A Pieter-Jan Drouillon Pieter-Jan @ designisdead.com