You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ariatosca.apache.org by gi...@apache.org on 2017/12/05 17:27:14 UTC
[incubator-ariatosca-website] branch asf-site updated: Automatic
Site Publish by Buildbot
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-ariatosca-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new b03be9d Automatic Site Publish by Buildbot
b03be9d is described below
commit b03be9d3cb863ed4a04300692f04a0a11bf7f502
Author: jenkins <bu...@apache.org>
AuthorDate: Tue Dec 5 17:27:13 2017 +0000
Automatic Site Publish by Buildbot
---
community/index.html | 11 +++++
getting-started/index.html | 95 ++++++++++++++++++++++++++++++++-------
samples/CentOS/centos7_aria011 | 36 +++++++++++++++
samples/Ubuntu/ubuntu1604_aria011 | 24 ++++++++++
sitemap.xml | 4 +-
5 files changed, 151 insertions(+), 19 deletions(-)
diff --git a/community/index.html b/community/index.html
index 26111b0..216fb72 100644
--- a/community/index.html
+++ b/community/index.html
@@ -169,6 +169,17 @@ See information on how to subscribe to mailing lists <a href="https://www.apache
<p>If you have any questions or ideas regarding contribution, please let us know on the dev@ariatosca.apache.org mailing list.</p>
+<h2 id="gain-writing-permissions-on-jira-and-confluence">Gain writing permissions on JIRA and Confluence</h2>
+
+<p>Once you have created an account on Confluence and JIRA, you need to request writing permissions by sending an email to the general@incubator.apache.org mailing list. You must include your JIRA and Confluence usernames.</p>
+
+<p>Be sure that you request permissions for the AriaTosca project and not Apache Incubator.</p>
+
+<h2 id="join-the-slack-channel">Join the Slack channel</h2>
+
+<p>To join ARIA on Slack, send an email to the dev@ariatosca.apache.org mailing list. One of the workspace admins will send you an invitation.</p>
+
+
</div>
</div>
</section>
diff --git a/getting-started/index.html b/getting-started/index.html
index e937840..6363457 100644
--- a/getting-started/index.html
+++ b/getting-started/index.html
@@ -145,20 +145,28 @@
<section id="intro">
<div class="container">
<div class="row">
- <h2 id="installation">Installation</h2>
+ <p>There are multiple ways of installing and running ARIA TOSCA. Specifically, there
+essentially two different branches of installations: user and developer. Both
+are documented below.</p>
-<p>ARIA is <a href="https://pypi.python.org/pypi/apache-ariatosca">available on PyPI</a>.</p>
+<p>While the instructions below strive to be complete, we’re human and make mistakes from time to time. In situations where something doesn’t work as described, do not hesitate to reach out to the community for assistance by sending email to dev@ariatosca.incubator.apache.org</p>
-<p>ARIA requires Python 2.6/2.7. Python 3 is currently not supported.</p>
+<h2 id="package-based-pip-package-installation">Package-Based PIP Package Installation</h2>
-<p>To install ARIA directly from PyPI (using a <code class="highlighter-rouge">wheel</code>), use::</p>
+<p>ARIA TOSCA is <a href="https://pypi.python.org/pypi/apache-ariatosca">available on PyPI</a>.</p>
+
+<p>ARIA TOSCA requires Python 2.6/2.7. Python 3 is currently not supported.</p>
+
+<p>To install ARIA TOSCA directly from PyPI (using a <code class="highlighter-rouge">wheel</code>), use::</p>
<div class="highlighter-rouge"><pre class="highlight"><code>pip install --upgrade pip setuptools
pip install apache-ariatosca
</code></pre>
</div>
-<p>To install ARIA from source, download the source tarball from
+<h2 id="source-based-pip-package-installation">Source-based PIP Package Installation</h2>
+
+<p>To install ARIA TOSCA from source, download the source tarball from
<a href="https://pypi.python.org/pypi/apache-ariatosca">PyPI</a>, extract and <code class="highlighter-rouge">cd</code> into the extract dir, and run::</p>
<div class="highlighter-rouge"><pre class="highlight"><code>pip install --upgrade pip setuptools
@@ -169,7 +177,7 @@ pip install .
<table>
<tbody>
<tr>
- <td>The source package comes along with relevant examples, documentation, <code class="highlighter-rouge">requirements.txt</code> (for installing specifically the frozen dependencies’ versions with which ARIA was tested) and more.</td>
+ <td>The source package comes along with relevant examples, documentation, <code class="highlighter-rouge">requirements.txt</code> (for installing specifically the frozen dependencies’ versions with which ARIA TOSCA was tested) and more.</td>
</tr>
<tr>
<td> </td>
@@ -178,7 +186,7 @@ pip install .
<td> </td>
</tr>
<tr>
- <td>ARIA has additional optional dependencies. These are required for running operations over SSH.</td>
+ <td>ARIA TOSCA has additional optional dependencies. These are required for running operations over SSH.</td>
</tr>
<tr>
<td>Below are instructions on how to install these dependencies, including required system dependencies per OS.</td>
@@ -197,14 +205,14 @@ pip install .
<p><strong>Ubuntu/Debian</strong> (tested on Ubuntu14.04, Ubuntu16.04)::</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>apt-get install -y python-dev gcc libffi-dev libssl-dev
+<div class="highlighter-rouge"><pre class="highlight"><code>apt-get install -y python-dev gcc libffi-dev libssl-dev
pip install apache-ariatosca[ssh]
</code></pre>
</div>
<p><strong>Centos</strong> (tested on Centos6.6, Centos7)::</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>yum install -y python-devel gcc libffi-devel openssl-devel
+<div class="highlighter-rouge"><pre class="highlight"><code>yum install -y python-devel gcc libffi-devel openssl-devel
pip install apache-ariatosca[ssh]
</code></pre>
</div>
@@ -236,24 +244,67 @@ python get-pip.py
</code></pre>
</div>
-<h2 id="getting-started">Getting Started</h2>
+<h2 id="developer-installation">Developer Installation</h2>
+
+<p>Developers will want to pull their base code from github and then
+build from that locally. Note there are two code repositories for
+ARIA TOSCA: one for the website and one for the main code base. Instructions
+for pulling and running each are detailed below.</p>
+
+<p><strong>Ubuntu/Debian</strong> (tested on Ubuntu14.04, Ubuntu16.04):</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>apt-get install -y python-dev gcc libffi-dev libssl-dev git
+
+# In addition to the above, install the following for website development
+sudo apt-get install ruby-dev
+sudo gem install jekyll bundler
+# you may have to install jekyll's dependancies
+bundle install
+</code></pre>
+</div>
+
+<p><strong>Centos</strong> (tested on Centos6.6, Centos7):</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>yum install -y python-devel gcc libffi-devel openssl-devel
+
+# In addition to the above, install the following for website development
+sudo yum install ruby-dev
+sudo gem install jekyll bundler
+# you may have to install jekyll's dependancies
+bundle install
+</code></pre>
+</div>
+
+<p><strong>Building from your pulled code</strong> :</p>
+
+<p>Instructions are <a href="https://cwiki.apache.org/confluence/display/ARIATOSCA/Contributing+Code">here</a></p>
+
+<h2 id="running-the-generated-website">Running The Generated Website</h2>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>The website is created using the Jekyll system. Launch the web server using the following and then browse to the URL indicated by jekyll's output:
+
+bundle exec jekyll serve
+</code></pre>
+</div>
+
+<h2 id="hello-world-example">“Hello World” Example</h2>
<p>This section will describe how to run a simple “Hello World” example.</p>
-<p>First, provide ARIA with the ARIA “hello world”(can be download <a href="https://github.com/apache/incubator-ariatosca/tree/master/examples/hello-world">here</a>) service-template and name it (e.g.
-<code class="highlighter-rouge">my-service-template</code>)::</p>
+<p>First, provide ARIA TOSCA with the ARIA TOSCA”hello world” template (can be downloaded <a href="https://github.com/apache/incubator-ariatosca/tree/master/examples/hello-world">here</a>) service-template and name it (e.g.
+<code class="highlighter-rouge">my-service-template</code>):</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>aria service-templates store examples/hello-world/helloworld.yaml my-service-template
+<div class="highlighter-rouge"><pre class="highlight"><code>aria service-templates store examples/hello-world/hello-world.yaml my-service-template
</code></pre>
</div>
-<p>Now create a service based on this service-template and name it (e.g. <code class="highlighter-rouge">my-service</code>)::</p>
+<p>Now create a service based on this service-template and name it (e.g. <code class="highlighter-rouge">my-service</code>):</p>
<div class="highlighter-rouge"><pre class="highlight"><code>aria services create my-service -t my-service-template
</code></pre>
</div>
-<p>Finally, start an <code class="highlighter-rouge">install</code> workflow execution on <code class="highlighter-rouge">my-service</code> like so::</p>
+<p>Finally, start an <code class="highlighter-rouge">install</code> workflow execution on <code class="highlighter-rouge">my-service</code> like so:</p>
<div class="highlighter-rouge"><pre class="highlight"><code>aria executions start install -s my-service
</code></pre>
@@ -262,7 +313,7 @@ python get-pip.py
<p>You should now have a simple web-server running on your local machine. You can try visiting
<code class="highlighter-rouge">http://localhost:9090</code> to view your deployed application.</p>
-<p>To uninstall and clean your environment, follow these steps::</p>
+<p>To uninstall and clean your environment, follow these steps:</p>
<div class="highlighter-rouge"><pre class="highlight"><code>aria executions start uninstall -s my-service
aria services delete my-service
@@ -272,9 +323,19 @@ aria service-templates delete my-service-template
<h2 id="license">License</h2>
-<p>ARIA is licensed under the
+<p>ARIA TOSCA is licensed under the
<a href="https://github.com/apache/incubator-ariatosca/blob/master/LICENSE">Apache License 2.0</a>.</p>
+<h2 id="sample-installcommand-files-for-different-aria-tosca-releases">Sample install/command files for different ARIA TOSCA releases</h2>
+
+<h2 id="011">0.1.1</h2>
+
+<p><a href="https://github.com/apache/incubator-ariatosca-website/samples/Ubuntu/ubuntu1604_aria011">Ubuntu 16.04</a></p>
+
+<p><a href="https://github.com/apache/incubator-ariatosca-website/samples/CentOS/centos7_aria011">CenOS 7</a></p>
+
+<p>Docker TBD</p>
+
</div>
</div>
</section>
diff --git a/samples/CentOS/centos7_aria011 b/samples/CentOS/centos7_aria011
new file mode 100644
index 0000000..18e0f8f
--- /dev/null
+++ b/samples/CentOS/centos7_aria011
@@ -0,0 +1,36 @@
+#Below commands to install aria may need to be run with root priviliges
+yum -y update
+
+yum clean all
+
+yum install -y yum-plugin-ovl
+
+yum install -y python-devel gcc libffi-devel openssl-devel epel-release curl git
+
+yum install wget -y
+
+curl "https://bootstrap.pypa.io/get-pip.py" -o "get-pip.py"
+
+python get-pip.py
+
+pip install --upgrade pip setuptools
+
+pip install apache-ariatosca[ssh]==0.1.1 --no-binary apache-ariatosca
+
+#Below commands are to ensure we get the correct example template files
+cd /tmp
+
+git clone https://github.com/apache/incubator-ariatosca.git /tmp/incubator-ariatosca
+
+cd /tmp/incubator-ariatosca
+
+git checkout tags/0.1.1
+
+#Below commands to be run from the /tmp/incubator-ariatosca directory
+aria service-templates store examples/hello-world/helloworld.yaml my-service-template
+
+aria services create my-service -t my-service-template
+
+aria executions start install -s my-service
+
+#Next launch a web browser and type http://localhost:9090
diff --git a/samples/Ubuntu/ubuntu1604_aria011 b/samples/Ubuntu/ubuntu1604_aria011
new file mode 100644
index 0000000..3916a80
--- /dev/null
+++ b/samples/Ubuntu/ubuntu1604_aria011
@@ -0,0 +1,24 @@
+#Below commands to install aria may need to be run with root priviliges
+apt-get update && apt-get install -y python-dev gcc libffi-dev libssl-dev python-pip git wget
+
+pip install --upgrade pip setuptools
+
+pip install apache-ariatosca[ssh]==0.1.1 --no-binary apache-ariatosca
+
+#Below commands are to ensure we get the correct example template files
+cd /tmp
+
+git clone https://github.com/apache/incubator-ariatosca.git /tmp/incubator-ariatosca
+
+cd /tmp/incubator-ariatosca
+
+git checkout tags/0.1.1
+
+#Below commands to be run from the /tmp/incubator-ariatosca directory
+aria service-templates store examples/hello-world/helloworld.yaml my-service-template
+
+aria services create my-service -t my-service-template
+
+aria executions start install -s my-service
+
+#Next launch a web browser and type http://localhost:9090
diff --git a/sitemap.xml b/sitemap.xml
index b67b1b7..6626e86 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -17,10 +17,10 @@
</url>
<url>
<loc>/css/attach/index.html</loc>
-<lastmod>2017-11-08T09:13:14+00:00</lastmod>
+<lastmod>2017-12-05T17:26:31+00:00</lastmod>
</url>
<url>
<loc>/js/attach/index.html</loc>
-<lastmod>2017-11-08T09:13:14+00:00</lastmod>
+<lastmod>2017-12-05T17:26:31+00:00</lastmod>
</url>
</urlset>
--
To stop receiving notification emails like this one, please contact
['"commits@ariatosca.apache.org" <co...@ariatosca.apache.org>'].