HADOOP-14460. Azure: update doc for live and contract tests. Contributed by Mingliang Liu
Project: http://git-wip-us.apache.org/repos/asf/hadoop/repo Commit: http://git-wip-us.apache.org/repos/asf/hadoop/commit/5c6f22d6 Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/5c6f22d6 Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/5c6f22d6 Branch: refs/heads/HDFS-7240 Commit: 5c6f22d62ea9e6fbe4e5411d5934958fcbf15dac Parents: 93f2aaf Author: Mingliang Liu <lium...@apache.org> Authored: Wed May 31 14:55:39 2017 -0700 Committer: Xiaoyu Yao <x...@apache.org> Committed: Thu Jun 8 10:44:49 2017 -0700 ---------------------------------------------------------------------- .../hadoop-azure/src/site/markdown/index.md | 90 ++++++++++++-------- 1 file changed, 56 insertions(+), 34 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hadoop/blob/5c6f22d6/hadoop-tools/hadoop-azure/src/site/markdown/index.md ---------------------------------------------------------------------- diff --git a/hadoop-tools/hadoop-azure/src/site/markdown/index.md b/hadoop-tools/hadoop-azure/src/site/markdown/index.md index 1d1274b..1dca3b9 100644 --- a/hadoop-tools/hadoop-azure/src/site/markdown/index.md +++ b/hadoop-tools/hadoop-azure/src/site/markdown/index.md @@ -396,42 +396,64 @@ To resolve this, restart the Azure Emulator. Ensure it v3.2 or later. It's also possible to run tests against a live Azure Storage account by saving a file to `src/test/resources/azure-auth-keys.xml` and setting -`fs.azure.test.account.name` to the name of the storage account. +the name of the storage account and its access key. For example: +```xml +<?xml version="1.0"?> +<?xml-stylesheet type="text/xsl" href="configuration.xsl"?> +<configuration> + <property> + <name>fs.azure.test.account.name</name> + <value>{ACCOUNTNAME}.blob.core.windows.net</value> + </property> + <property> + <name>fs.azure.account.key.{ACCOUNTNAME}.blob.core.windows.net</name> + <value>{ACCOUNT ACCESS KEY}</value> + </property> +</configuration> +``` - <?xml version="1.0"?> - <?xml-stylesheet type="text/xsl" href="configuration.xsl"?> - <configuration> - <property> - <name>fs.azure.account.key.youraccount.blob.core.windows.net</name> - <value>YOUR ACCESS KEY</value> - </property> - - <property> - <name>fs.azure.test.account.name</name> - <value>youraccount</value> - </property> - </configuration> - -To run contract tests add live Azure Storage account by saving a -file to `src/test/resources/azure-auth-keys.xml`. -For example: +To run contract tests, set the WASB file system URI in `src/test/resources/azure-auth-keys.xml` +and the account access key. For example: + +```xml +<?xml version="1.0"?> +<?xml-stylesheet type="text/xsl" href="configuration.xsl"?> +<configuration> + <property> + <name>fs.contract.test.fs.wasb</name> + <value>wasb://{CONTAINERNAME}@{ACCOUNTNAME}.blob.core.windows.net</value> + <description>The name of the azure file system for testing.</description> + </property> + <property> + <name>fs.azure.account.key.{ACCOUNTNAME}.blob.core.windows.net</name> + <value>{ACCOUNT ACCESS KEY}</value> + </property> +</configuration> +``` - <?xml version="1.0"?> - <?xml-stylesheet type="text/xsl" href="configuration.xsl"?> - <configuration> - <property> - <name>fs.contract.test.fs.wasb</name> - <value>wasb://{CONTAINERNAME}@{ACCOUNTNAME}.blob.core.windows.net</value> - <description>The name of the azure file system for testing.</description> - </property> - - <property> - <name>fs.azure.account.key.{ACCOUNTNAME}.blob.core.windows.net</name> - <value>{ACCOUNTKEY}</value> - </property> - </configuration> - -DO NOT ADD azure-auth-keys.xml TO REVISION CONTROL. The keys to your Azure +Overall, to run all the tests using `mvn test`, a sample `azure-auth-keys.xml` is like following: + +```xml +<?xml version="1.0"?> +<?xml-stylesheet type="text/xsl" href="configuration.xsl"?> +<configuration> + <property> + <name>fs.azure.test.account.name</name> + <value>{ACCOUNTNAME}.blob.core.windows.net</value> + </property> + <property> + <name>fs.azure.account.key.{ACCOUNTNAME}.blob.core.windows.net</name> + <value>{ACCOUNT ACCESS KEY}</value> + </property> + <property> + <name>fs.contract.test.fs.wasb</name> + <value>wasb://{CONTAINERNAME}@{ACCOUNTNAME}.blob.core.windows.net</value> + </property> +</configuration> +``` + +DO NOT ADD `azure-auth-keys.xml` TO REVISION CONTROL. The keys to your Azure Storage account are a secret and must not be shared. + --------------------------------------------------------------------- To unsubscribe, e-mail: common-commits-unsubscr...@hadoop.apache.org For additional commands, e-mail: common-commits-h...@hadoop.apache.org
