Apache
/
hadoop
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

HADOOP-14460. Azure: update doc for live and contract tests. Contributed by Mingliang Liu

This commit is contained in:
Mingliang Liu 2017-05-31 14:55:39 -07:00
parent ff3103556b
commit ece33208b8
1 changed files with 53 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
hadoop-tools/hadoop-azure/src/site/markdown/index.md
View File

@ -396,28 +396,28 @@ 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 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 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: For example:
```xml
<?xml version="1.0"?> <?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="configuration.xsl"?> <?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
<configuration> <configuration>
<property>
<name>fs.azure.account.key.youraccount.blob.core.windows.net</name>
<value>YOUR ACCESS KEY</value>
</property>
<property> <property>
<name>fs.azure.test.account.name</name> <name>fs.azure.test.account.name</name>
<value>youraccount</value> <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>
</configuration> </configuration>
```
To run contract tests add live Azure Storage account by saving a To run contract tests, set the WASB file system URI in `src/test/resources/azure-auth-keys.xml`
file to `src/test/resources/azure-auth-keys.xml`. and the account access key. For example:
For example:
```xml
<?xml version="1.0"?> <?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="configuration.xsl"?> <?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
<configuration> <configuration>
@ -426,12 +426,34 @@ For example:
<value>wasb://{CONTAINERNAME}@{ACCOUNTNAME}.blob.core.windows.net</value> <value>wasb://{CONTAINERNAME}@{ACCOUNTNAME}.blob.core.windows.net</value>
<description>The name of the azure file system for testing.</description> <description>The name of the azure file system for testing.</description>
</property> </property>
<property> <property>
<name>fs.azure.account.key.{ACCOUNTNAME}.blob.core.windows.net</name> <name>fs.azure.account.key.{ACCOUNTNAME}.blob.core.windows.net</name>
<value>{ACCOUNTKEY}</value> <value>{ACCOUNT ACCESS KEY}</value>
</property> </property>
</configuration> </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. Storage account are a secret and must not be shared.