There are several different ways to handle file transfers between AEM and your local file system. In this post, I’m going to go over a couple command-line tools to transfers files between my local file system and AEM 6.5: AEM repo tool and FileVault VLT.
AEM repo tool
Follow the instructions at Adobe-Marketing-Cloud / tools / repo to install on your system. For Linux, I used curl to install the
repo bash script since it is just a single file. e.g.,curl -L https://raw.githubusercontent.com/Adobe-Marketing-Cloud/tools/master/repo/repo -o $HOME/bin/repochmod +x $HOME/bin/repo
Add the
repo script to your environment PATH as needed.
Config
Defaults
Property
|
Value
|
If your server and/or credentials differ from the defaults, in your project folder, create a
.repo file with your AEM server location and credentials. e.g.,
.repo
credentials=gilfoyle:secret
Checkout
Specify the AEM JCR path to transfer from. Unlike
vlt, you can only perform an action on a single path. There is not an option for a batch transfer that can use a filter.cdmyprojectrepo checkout /apps/weretail
This will create a
jcr_root folder containing the checked out folders and files.
Use the
put the command to transfer updated files into the AEM JCR.cdjcr_root/apps/weretail/components/content/heroimagerepo put heroimage.html
Use the
-s option with a command to specify a different server to interact with. For example, transfer to the publish instance on port 4503.repo put -s http://localhost:4503 heroimage.html
Commands
Command
|
Alias
|
Description
|
For help on a command, use
repo <command> -h. e.g., repo -h get. For the entire help contents, repo -h.
IDE Integration
Adobe-Marketing-Cloud / tools / repo / README contains a good bit of information on how to integrate the commands into various IDE’s including Visual Studio Code and IntelliJ. These integration methods should also work for the FileVault VLT commands.
VS Code
Create a
tasks.json for the curent workspace. e.g., .vscode/tasks.json
Select Terminal > Configure Tasks > Create
tasks.json file from template > Others.
Folder actions will be performed on the folder of the currently opened file.
tasks.json
{"version": "2.0.0","tasks": [{"label": "put file","type": "shell","command": "repo put -f ${file}","problemMatcher": []},{"label": "put folder","type": "shell","command": "repo put -f ${fileDirname}","problemMatcher": []},{"label": "get file","type": "shell","command": "repo get -f ${file}","problemMatcher": []},{"label": "get folder","type": "shell","command": "repo get -f ${fileDirname}","problemMatcher": []}]}
For more information on Visual Studio Code integration, refer to the VS Code Task documentation.
FileVault VLT
The Apache Jackrabbit FileVault VLT command line tool maps the contents of an AEM Java Content Repository (JCR) to your file system.
To get the latest FileVault, clone or download the jackrabbit-filevault repo from github.
In AEM versions 6.3 and earlier, you could install FileVault from its archive in the
crx-quickstart/opt/filevault/ folder of your AEM instance. For example, AEM 6.3, includes both filevault-3.1.38.tgz and filevault-3.1.38.zip.
Next, build FileVault using Maven. e.g.,
cdjackrabbit-filevaultmvn clean install
Check the documentation for build requirements. At the time of this writing, Maven 3.3.9 (or higher) with Java 8 (or higher) required. I used openjdk version 1.8.0_232 and Maven 3.6.2 when building.
The initial build will take a few minutes, for example:
[INFO] ------------------------------------------------------------------------[INFO] Reactor Summary for Apache Jackrabbit FileVault (Reactor Project) 3.4.1-SNAPSHOT:[INFO][INFO] Apache Jackrabbit FileVault (Parent Project) ....... SUCCESS [ 9.574 s][INFO] Apache Jackrabbit FileVault Core Bundle ............ SUCCESS [02:31 min][INFO] Apache Jackrabbit FileVault Diff (Diff utilities) .. SUCCESS [ 1.549 s][INFO] Apache Jackrabbit FileVault JCR Remoting Service ... SUCCESS [ 1.658 s][INFO] Apache Jackrabbit FileVault RCP Server Bundle ...... SUCCESS [ 1.224 s][INFO] Apache Jackrabbit FileVault Documentation .......... SUCCESS [ 0.066 s][INFO] Apache Jackrabbit FileVault Sync Service ........... SUCCESS [ 1.611 s][INFO] Apache Jackrabbit FileVault Platform Interaction ... SUCCESS [ 0.947 s][INFO] Apache Jackrabbit FileVault Command Line Interface . SUCCESS [ 2.600 s][INFO] Apache Jackrabbit FileVault Package Hook Example ... SUCCESS [ 2.040 s][INFO] Apache Jackrabbit FileVault Package Hook Sling Example SUCCESS [ 0.350 s][INFO] Apache Jackrabbit FileVault Validation ............. SUCCESS [ 3.375 s][INFO] Apache Jackrabbit FileVault (Reactor Project) ...... SUCCESS [ 13.789 s][INFO] ------------------------------------------------------------------------[INFO] BUILD SUCCESS[INFO] ------------------------------------------------------------------------[INFO] Total time: 03:15 min[INFO] Finished at: 2019-12-06T18:42:47-05:00[INFO] ------------------------------------------------------------------------
Installation
Extract the archive from the
vault-cli/target directory in the build.
For example,
cdvault-cli/targettar xfz vault-cli-3.4.1-SNAPSHOT-bin.tar.gz
If you like, rename the directory for the PATH so it does not contain
-SNAPSHOT. e.g.,mv vault-cli-3.4.1-SNAPSHOT vault-cli-3.4.1
Add the
bin directory which contains vlt and vlt.bat to your environment PATH. For example, in Linux, this can be done in the users .profile.exportPATH=$PATH:$HOME/aem/jackrabbit-filevault/vault-cli/target/vault-cli-3.4.1/bin
Once you’ve updated your environment PATH to include the
bin directory, verify using the vlt command (you may have to logout for your PATH changes to take effect).vlt --help
Checkout
Using
vlt co, you can checkout files from the AEM JCR.
Note: this example will checkout all of the files. In a default AEM 6.5 author instance, there are over 2 GB’s of files.
cdjcr_rootvlt --credentials admin:admin co --force http://localhost:4502/crx
The credentials only need to be specified on the initial checkout and are added to
~/.vault/auth.xml for subsequent operations.
Checkout Filter
A
META-INF manifest folder exists alongside the jcr_root. Create this folder if needed and add a vault/filter.xml file. Now you can checkout just the directories you specify in this filter instead of the entire JCR.
filter.xml
<?xml version="1.0" encoding="UTF-8"?><workspaceFilterversion="1.0"><filter root="/apps/weretail"/><filter root="/apps/we-retail-communities"/><filter root="/apps/we-retail-screens"/><filter root="/content/we-retail"/></workspaceFilter>
Save the filter and run
vlt checkout. Use --force to overwrite the previous checkout as needed. e.g.,cdjcr_rootvlt co --force http://localhost:4502/crx
Commit
Update and commit a file back into the AEM JCR to test the operation. For example,
apps/weretail/components/content/heroimage/heroimage.html<sly data-sly-use.heroImage="we.retail.core.model.HeroImage"><div class="${heroImage.classList} jumbotron"style="background-image: url('${(properties.fileReference || properties.fileName) ? heroImage.image.src : '' @ context='uri'}');"><div class="container cq-dd-image"><div class="we-HeroImage-wrapper"><p class="h3">${properties.heading}</p><strong class="we-HeroImage-title h1">${properties.title || currentPage.title}</strong><h3 style="font-weight:bold;text-shadow: 2px 2px 4px #000000;">VLT TESTING</h3><p data-sly-test="${properties.buttonLabel && properties.buttonLinkTo}"><a class="btn btn-primary btn-action" href="${properties.buttonLinkTo @ extension = 'html'}" role="button">${properties.buttonLabel}</a></p></div></div></div></sly>
Commit the change with the
-v option (verbose output) to see what is being transferred. e.g.,vlt ci -v apps/weretail/components/content/heroimage/heroimage.html
Verify the update, e.g.,
View a page that has the
heroimage the component as published, http://localhost:4502/content/we-retail/us/en.html?wcmmode=disabled
VLT Commands
Command
|
Alias
|
Description
|
For help on a command, use
vlt --help plus the name of the command. e.g., vlt --help commit
No comments:
Post a Comment
If you have any doubts or questions, please let us know.