From 6faf66db05a5b3c2832527f609dc3c5a4780b819 Mon Sep 17 00:00:00 2001 From: Derek Smart Date: Thu, 31 May 2018 15:04:56 -0400 Subject: [PATCH] update readme Signed-off-by: Derek Smart --- README.md | 71 ++++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 57 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 9b1af33..f0c4351 100644 --- a/README.md +++ b/README.md @@ -1,28 +1,46 @@ # Delphix Target Host +[![Chef cookbook](https://img.shields.io/cookbook/v/delphix.svg)](https://supermarket.chef.io/cookbooks/delphix) + +Configure a Linux system as a target host for the Delphix platform. + #### Table of Contents +1. [Description](#description) +2. [Installation](#installation) +3. [Usage](#usage) +4. [Contribute](#contribute) + * [Code of conduct](#code-of-conduct) + * [Community Guidelines](#community-guidelines) + * [Contributor Agreement](#contributor-agreement) +5. [Reporting Issues](#reporting-issues) +6. [Statement of Support](#statement-of-support) +7. [License](#license) - 1. [Description](#description) - 2. [Setup - The basics of getting started with delphix](#setup) - * [Beginning with Delphix](#beginning-with-delphix) - 3. [Usage - Configuration options and additional functionality](#usage) - 5. [Limitations - OS compatibility, etc.](#limitations) - 6. [License](#license) +## Description -## Description This cookbook will configure a Linux system for use as a target host in the Delphix platform. This includes installing all required packages, and creating a `delphix` user with sufficient sudo privileges support all platform operations, most notably managing NFS mounts. The resulting host can be used with a standard username, directories, and SSH key access. -## Setup +## Installation + +Berkshelf:
+`cookbook 'delphix', '~> 0.1.2'` + +Policyfile:
+`cookbook 'delphix', '~> 0.1.2', :supermarket` + +Knife:
+`knife cookbook site install delphix`
+`knife cookbook site download delphix` + +## Usage + The cookbook provides a mechanism for configuring the `delphix` user with a single engine public SSH key in `/home/delphix/.ssh/authorized_keys`. In the event that you are building a cloud image and want to configure the SSH key at runtime, you can use cloud init (as described for AWS [here](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html)) to append one or more SSH keys to the `authorized_keys` file on first boot. To get the public SSH key of an engine, use the `system get sshPublicKey` CLI command. -### Beginning with Delphix The Delphix cookbook can configure the target host automatically with default settings. If you want to set up a target host quickly, apply the following manifest: ``` delphix::default ``` - -## Usage In the event that your target host needs to have a different user:group than `delphix` or different mount and toolkit directories, chnage the following default attributes to fit your situation. ``` @@ -40,10 +58,35 @@ The delphix cookbook configures a target host by default, but if you only want t delphix::config_targethost ``` -## Limitations +#### Limitations This cookbook has been manually tested against latest Ubuntu and CentOS AMIs, but there is no reason it should not work with any RedHat or Debian variant. -## License +## Contribute + +1. Fork the project. +2. Make your bug fix or new feature. +3. Add tests for your code. +4. Send a pull request. + +Contributions must be signed as `User Name `. Make sure to [set up Git with user name and email address](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup). Bug fixes should branch from the current stable branch. New features should be based on the `master` branch. + +#### Code of Conduct + +This project operates under the [Delphix Code of Conduct](https://delphix.github.io/code-of-conduct.html). By participating in this project you agree to abide by its terms. + +#### Contributor Agreement + +All contributors are required to sign the Delphix Contributor agreement prior to contributing code to an open source repository. This process is handled automatically by [cla-assistant](https://cla-assistant.io/). Simply open a pull request and a bot will automatically check to see if you have signed the latest agreement. If not, you will be prompted to do so as part of the pull request process. + +## Reporting Issues + +Issues should be reported in the GitHub repo's issue tab. Include a link to it. + +## Statement of Support + +This software is provided as-is, without warranty of any kind or commercial support through Delphix. See the associated license for additional details. Questions, issues, feature requests, and contributions should be directed to the community as outlined in the [Delphix Community Guidelines](https://delphix.github.io/community-guidelines.html). + +## License -Apache 2.0 +This is code is licensed under the Apache License 2.0. Full license is available [here](./LICENSE).