You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openwhisk.apache.org by mr...@apache.org on 2018/07/10 18:55:01 UTC

[incubator-openwhisk-deploy-openshift] 02/02: Iniatialize repo. with Apache OpenWhisk standard files.

This is an automated email from the ASF dual-hosted git repository.

mrutkowski pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-openwhisk-deploy-openshift.git

commit 9f0150346c0abba1417109f6cdccf15be97231ab
Author: Matt Rutkowski <mr...@us.ibm.com>
AuthorDate: Tue Jul 10 13:54:40 2018 -0500

    Iniatialize repo. with Apache OpenWhisk standard files.
---
 README.md | 106 ++++++--------------------------------------------------------
 1 file changed, 9 insertions(+), 97 deletions(-)

diff --git a/README.md b/README.md
index cb047b1..fd1ae0e 100644
--- a/README.md
+++ b/README.md
@@ -17,112 +17,24 @@
 #
 -->
 
-# OpenWhisk
+# OpenWhisk Deployment on OpenShift
 
-[![Build Status](https://travis-ci.org/apache/incubator-openwhisk.svg?branch=master)](https://travis-ci.org/apache/incubator-openwhisk)
+[![Build Status](https://travis-ci.org/apache/incubator-openwhisk-deploy-openshift.svg?branch=master)](https://travis-ci.org/apache/incubator-openwhisk)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)
-[![Join Slack](https://img.shields.io/badge/join-slack-9B69A0.svg)](http://slack.openwhisk.org/)
-[![codecov](https://codecov.io/gh/apache/incubator-openwhisk/branch/master/graph/badge.svg)](https://codecov.io/gh/apache/incubator-openwhisk)
 
-OpenWhisk is a cloud-first distributed event-based programming service. It provides a programming model to upload event handlers to a cloud service, and register the handlers to respond to various events. Learn more at [http://openwhisk.incubator.apache.org](http://openwhisk.incubator.apache.org).
+This repository can be used to deploy OpenWhisk to the OpenShift platform.
 
+# Table of Contents
 
-* [Quick Start](#quick-start) (Docker-Compose)
-* [Native development](#native-development) (Mac and Ubuntu)
-* [Kubernetes](#kubernetes-setup)
-* [Vagrant](#vagrant-setup)
-* [Learn concepts and commands](#learn-concepts-and-commands)
-* [Issues](#issues)
-* [Slack](#slack)
+TBD
 
-### Quick Start
-The easiest way to start using OpenWhisk is to get Docker installed on on Mac, Windows or Linux. The [Docker website](https://docs.docker.com/install/) has details instructions on getting the tools installed. This does not give you a production deployment but gives you enough of the pieces to start writing functions and seeing them run.
+# Pre-requisites
 
-```
-git clone https://github.com/apache/incubator-openwhisk-devtools.git
-cd incubator-openwhisk-devtools/docker-compose
-make quick-start
-```
+TBD
 
-For more detailed instructions or if you encounter problems see the [OpenWhisk-dev tools](https://github.com/apache/incubator-openwhisk-devtools/blob/master/docker-compose/README.md) project.
+# Installation and Setup
 
-### Kubernetes Setup
-
-Another path to quickly starting to use OpenWhisk is to install it on a Kubernetes cluster.  OpenWhisk can be installed on Minikube, on a managed Kubernetes cluster provisioned from a public cloud provider, or on a Kubernetes cluster you manage yourself. To get started,
-
-```
-git clone https://github.com/apache/incubator-openwhisk-deploy-kube.git
-```
-
-Then follow the instructions in the [OpenWhisk on Kubernetes README.md](https://github.com/apache/incubator-openwhisk-deploy-kube/blob/master/README.md).
-
-### Vagrant Setup
-A [Vagrant](http://vagrantup.com) machine is also available to run OpenWhisk on Mac, Windows PC or GNU/Linux but isn't used by as much of the dev team so sometimes lags behind.
-Download and install [VirtualBox](https://www.virtualbox.org/wiki/Downloads) and [Vagrant](https://www.vagrantup.com/downloads.html) for your operating system and architecture.
-
-**Note:** For Windows, you may need to install an ssh client in order to use the command `vagrant ssh`. Cygwin works well for this, and Git Bash comes with an ssh client you can point to. If you run the command and no ssh is installed, Vagrant will give you some options to try.
-
-Follow these step to run your first OpenWhisk Action:
-```
-# Clone openwhisk
-git clone --depth=1 https://github.com/apache/incubator-openwhisk.git openwhisk
-
-# Change directory to tools/vagrant
-cd openwhisk/tools/vagrant
-
-# Run script to create vm and run hello action
-./hello
-```
-
-Wait for hello action output:
-```
-wsk action invoke /whisk.system/utils/echo -p message hello --result
-{
-    "message": "hello"
-}
-```
-
-These steps were tested on Mac OS X El Capitan, Ubuntu 14.04.3 LTS and Windows using Vagrant.
-For more information about using OpenWhisk on Vagrant see the [tools/vagrant/README.md](tools/vagrant/README.md)
-
-During the Vagrant setup, the Oracle JDK 8 is used as the default Java environment. If you would like to use OpenJDK 8, please change the line "su vagrant -c 'source all.sh oracle'" into "su vagrant -c 'source all.sh'" in tools/vagrant/Vagrantfile.
-
-### Native development
-
-Docker must be natively installed in order to build and deploy OpenWhisk.
-If you plan to make contributions to OpenWhisk, we recommend either a Mac or Ubuntu environment.
-
-* [Setup Mac for OpenWhisk](tools/macos/README.md)
-* [Setup Ubuntu for OpenWhisk](tools/ubuntu-setup/README.md)
-
-### Learn concepts and commands
-
-Browse the [documentation](docs/) to learn more. Here are some topics you may be
-interested in:
-
-- [System overview](docs/about.md)
-- [Getting Started](docs/README.md)
-- [Create and invoke actions](docs/actions.md)
-- [Create triggers and rules](docs/triggers_rules.md)
-- [Use and create packages](docs/packages.md)
-- [Browse and use the catalog](docs/catalog.md)
-- [Using the OpenWhisk mobile SDK](docs/mobile_sdk.md)
-- [OpenWhisk system details](docs/reference.md)
-- [Implementing feeds](docs/feeds.md)
-
-### Repository Structure
-
-The OpenWhisk system is built from a number of components.  The picture below groups the components by their GitHub repos. Please open issues for a component against the appropriate repo (if in doubt just open against the main openwhisk repo).
-
-![component/repo mapping](docs/images/components_to_repos.png)
-
-### Issues
-
-Report bugs, ask questions and request features [here on GitHub](../../issues).
-
-### Slack
-
-You can also join the OpenWhisk Team on Slack [https://openwhisk-team.slack.com](https://openwhisk-team.slack.com) and chat with developers. To get access to our public slack team, request an invite [https://openwhisk.incubator.apache.org/slack.html](https://openwhisk.incubator.apache.org/slack.html).
+TBD
 
 # Disclaimer