This is an automated email from the ASF dual-hosted git repository.
miki3421 pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/openserverless-site.git
The following commit(s) were added to refs/heads/main by this push:
new f87ac8fb updated the website (#93)
f87ac8fb is described below
commit f87ac8fbd4c1b44d01fe842896bf743c1d4876b7
Author: Michele Sciabarra <[email protected]>
AuthorDate: Wed Sep 9 13:27:43 2026 +0200
updated the website (#93)
Co-authored-by: Michele Sciabarra <[email protected]>
---
content/en/_index.md | 14 +--
content/en/about/openserverless-diagram.webp | Bin 154580 -> 117940 bytes
content/en/blog/articles/building-mcp-servers.md | 2 +-
content/en/community/_index.md | 73 ++++++++++++-
content/en/docs/cli/_index.md | 3 +-
content/en/docs/installation/_index.md | 6 +-
content/en/docs/installation/download/_index.md | 63 -----------
content/en/docs/installation/install-cli/_index.md | 120 +++++++++++++++++++++
content/en/docs/installation/install/_index.md | 2 +-
.../en/docs/installation/install/cluster/_index.md | 2 +-
.../en/docs/installation/install/docker/_index.md | 2 +-
.../en/docs/installation/install/server/_index.md | 2 +-
.../installation/prereq/kubernetes/eks/_index.md | 2 +-
content/en/docs/installation/quickstart/_index.md | 2 +-
.../reference/references/advanced-cli/_index.md | 2 +-
content/en/openserverless-diagram.png | Bin 641483 -> 1188347
bytes
content/en/openserverless-diagram.webp | Bin 156352 -> 117940 bytes
hugo.yaml | 28 ++---
i18n/en.toml | 36 +++++++
19 files changed, 255 insertions(+), 104 deletions(-)
diff --git a/content/en/_index.md b/content/en/_index.md
index 4f1c149f..47f26ec1 100644
--- a/content/en/_index.md
+++ b/content/en/_index.md
@@ -7,8 +7,8 @@ title: Apache OpenServerless™
<a class="btn btn-lg btn-primary me-3 mb-4" href="/docs/">
Learn More <i class="fas fa-arrow-alt-circle-right ms-2"></i>
</a>
-<a class="btn btn-lg btn-secondary me-3 mb-4"
href="/docs/installation/download/">
- Download <i class="fas fa-download ms-2 "></i>
+<a class="btn btn-lg btn-secondary me-3 mb-4"
href="/docs/installation/install-cli/">
+ Install <i class="fas fa-download ms-2 "></i>
</a>
<h1 class="lead mt-5">Upgrading Kubernetes to a Serverless powerhouse to build
your cloud-native A.I. application!</h1>
@@ -25,17 +25,17 @@ title: Apache OpenServerless™
{{% blocks/section color="dark" type="row" %}}
-{{% blocks/feature icon="fab fa-reddit" title="Join our subreddit!"
url="https://reddit.com/r/openserverless"; %}}
-A friendly place to discuss Apache OpenServerless™
+{{% blocks/feature icon="fa fa-envelope" title="Join the mailing list!"
url="mailto:[email protected]"; %}}
+The primary channel of the project. Subscribe to
**[email protected]**
{{% /blocks/feature %}}
{{% blocks/feature icon="fab fa-github" title="Contributions welcome!"
url="https://github.com/apache/openserverless"; %}}
-We accept [Pull Request](https://github.com/google/docsy-example/pulls) on
**GitHub**. New contributors are always welcome!
+We accept [Pull Requests](https://github.com/apache/openserverless/pulls) on
**GitHub**. New contributors are always welcome!
{{% /blocks/feature %}}
-{{% blocks/feature icon="fab fa-x-twitter" title="Follow us on X.com!"
url="https://twitter.com/open_serverless"; %}}
-For announcement of latest features etc.
+{{% blocks/feature icon="fab fa-slack" title="Chat with us!"
url="https://the-asf.slack.com/archives/C07B6K5R3F0"; %}}
+Join the **#openserverless** channel on the ASF Slack
{{% /blocks/feature %}}
{{% /blocks/section %}}
diff --git a/content/en/about/openserverless-diagram.webp
b/content/en/about/openserverless-diagram.webp
index b387d443..92b6f42f 100644
Binary files a/content/en/about/openserverless-diagram.webp and
b/content/en/about/openserverless-diagram.webp differ
diff --git a/content/en/blog/articles/building-mcp-servers.md
b/content/en/blog/articles/building-mcp-servers.md
index 176bf0e4..929fed13 100644
--- a/content/en/blog/articles/building-mcp-servers.md
+++ b/content/en/blog/articles/building-mcp-servers.md
@@ -157,7 +157,7 @@ In this example, we use [5ire](https://5ire.app/), a free
AI assistant and MCP c
### Step 1: Install the `ops` CLI
-First, install the `ops` CLI. You can find installation instructions on the
[OpenServerless installation
page](https://openserverless.apache.org/docs/installation/download/).
+First, install the `ops` CLI. You can find installation instructions on the
[OpenServerless installation
page](https://openserverless.apache.org/docs/installation/install-cli/).
### Step 2: Add the MCP Plugin
diff --git a/content/en/community/_index.md b/content/en/community/_index.md
index 3f237b8a..9789afda 100644
--- a/content/en/community/_index.md
+++ b/content/en/community/_index.md
@@ -3,4 +3,75 @@ title: Community
menu: {main: {weight: 40}}
---
-<!--add blocks of content here to add more sections to the community page -->
+## Join the developer mailing list
+
+The mailing list `[email protected]` is the **primary channel**
of the
+project. Announcements, design discussions, release votes and decisions all
happen
+there — at the Apache Software Foundation, if it did not happen on the mailing
+list, it did not happen.
+
+You do not need to be a committer to join. Anyone can subscribe, read and post.
+
+### Subscribe
+
+1. Send an empty email to
+
[[email protected]](mailto:[email protected]).
+ The subject and body are ignored, so you can leave them blank.
+2. You will receive an automated confirmation request from
+ `[email protected]`. **Reply to it**, leaving the subject
as
+ it is — it carries a confirmation code. The body can be empty.
+3. A welcome message confirms that you are subscribed.
+
+If the confirmation request does not arrive within a few minutes, check your
spam
+folder.
+
+### Post a message
+
+Once subscribed, write to
+[[email protected]](mailto:[email protected]).
+
+A few conventions that make things easier for everyone:
+
+- Send plain text rather than HTML, and avoid attachments — paste logs and code
+ inline or link to a gist.
+- Keep one topic per thread, and reply below the text you are quoting.
+- Include your `ops -info` output and the version you are running when
reporting a
+ problem.
+
+### Read the archives
+
+Every message is public and permanently archived. You can browse and search the
+whole history — and read it before subscribing — at
+[lists.apache.org](https://lists.apache.org/[email protected]).
+
+### Unsubscribe
+
+Send an empty email to
+[[email protected]](mailto:[email protected])
+and reply to the confirmation request, exactly as when subscribing.
+
+## Sources and issues
+
+Development happens in the open on GitHub, in the
+[apache/openserverless](https://github.com/apache/openserverless) repository
and
+the related component repositories.
+
+Open an issue there to report a bug or request a feature, and send a pull
request
+to contribute a change. Larger changes are worth raising on the mailing list
first,
+so the discussion is visible to the whole community and archived with the
project.
+
+See the [contribution guidelines](/contribution-guidelines/) to get started.
+
+## Chat on the ASF Slack
+
+For quick questions and day to day conversation, join the **#openserverless**
+channel on the Apache Software Foundation Slack:
+[the-asf.slack.com/archives/C07B6K5R3F0](https://the-asf.slack.com/archives/C07B6K5R3F0).
+
+If you do not have an ASF Slack account, you can self-invite at
+[s.apache.org/slack-invite](https://s.apache.org/slack-invite) using any email
+address.
+
+Slack is convenient, but it is not the official record: anything that matters —
+proposals, decisions, votes — belongs on the mailing list, where it is archived
+and visible to everyone.
diff --git a/content/en/docs/cli/_index.md b/content/en/docs/cli/_index.md
index 5077f5cd..e5709adf 100644
--- a/content/en/docs/cli/_index.md
+++ b/content/en/docs/cli/_index.md
@@ -10,8 +10,7 @@ The `ops` command is the command line interface to
OpenServerless
It let’s you to install and manipulate the components of the system.
If it is not already included in the development environment provided
-you can [download the CLI suitable for your platform from here, and
-install it](/docs/installation/download/)
+you can [install the CLI for your platform from
here](/docs/installation/install-cli/)
## Login into the system
diff --git a/content/en/docs/installation/_index.md
b/content/en/docs/installation/_index.md
index c669ce7f..b9fa94ae 100644
--- a/content/en/docs/installation/_index.md
+++ b/content/en/docs/installation/_index.md
@@ -25,8 +25,8 @@ on.
OpenServerless can be installed in many environments, using our powerful
command line interface `ops`.
-So you should start downloading the CLI [from this
-page](/docs/installation/download/index.adoc).
+So you should start installing the CLI [from this
+page](/docs/installation/install-cli/).
Once you installed `ops`, before installing you need to [check the
prerequisites](/docs/installation/prereq/index.adoc) for the installation, and
satisfy
@@ -38,7 +38,7 @@ installation.
Finally, once you have:
-1. downloaded `ops`
+1. installed `ops`
2. satisfied the prerequisites
diff --git a/content/en/docs/installation/download/_index.md
b/content/en/docs/installation/download/_index.md
deleted file mode 100644
index 7595f903..00000000
--- a/content/en/docs/installation/download/_index.md
+++ /dev/null
@@ -1,63 +0,0 @@
----
-title: Download
-description: Download OpenServerless with ops CLI
-weight: 10
-draft: false
----
-## Download and Install `ops`
-
-### What is `ops`?
-
-As you can guess it helps with operations: ops is the
<strong>OP</strong>en<strong>S</strong>erverless CLI.
-
-It is a task executor on steroids.
-
-- it embeds task, wsk and a lot of other utility commands (check with ops
-help)
-- automatically download and update command line tools, prerequisites and tasks
-- taskfiles are organized in commands and subcommands, hierarchically and are
powered by docopt
-- it supports plugins
-
-The predefined set of tasks are all you need to install and manage an
OpenServerless cluster.
-
-### Download links
-You can install OpenServerless using its Command Line Interface, `ops`.
-
-{{< blockquote warning >}}
-Since we are in a preview phase, this is not an official link approved by the
Apache Software Foundation.
-{{< /blockquote >}}
-
-Quick install in Linux, MacOS and Windows with WSL or GitBash:
-
-```bash
-curl -sL bit.ly/get-ops | bash
-```
-
-Quick install in Windows with PowerShell
-
-Open a powershell. Then give these commands:
-
-```powershell
-Set-ExecutionPolicy Bypass -Scope Process -Force
-irm bit.ly/get-ops-exe | iex
-```
-
-### After the installation
-
-Once installed, in the first run `ops` will tell to update the tasks
-executing:
-
-`ops -update`
-
-This command updates the OpenServerless "tasks" (its internal logic) to the
-latest version. This command should be also executed frequently, as the
-tasks are continuously evolving and expanding.
-
-`ops` will suggest when to update them (at least once a day).
-
-You normally just need to update the tasks but sometimes you also need
-to update `ops` itself. The system will detect when it is the case and
-tell you what to do.
-
-### Where to find more details:
-
-For more details, please visit the Github page of [Openserverless
Cli](https://github.com/apache/openserverless-cli)
diff --git a/content/en/docs/installation/install-cli/_index.md
b/content/en/docs/installation/install-cli/_index.md
new file mode 100644
index 00000000..e846e5e5
--- /dev/null
+++ b/content/en/docs/installation/install-cli/_index.md
@@ -0,0 +1,120 @@
+---
+title: Install
+description: Install the ops CLI and create a local OpenServerless
+weight: 10
+draft: false
+aliases:
+ - /docs/installation/download/
+---
+## Install `ops`
+
+### What is `ops`?
+
+As you can guess it helps with operations: ops is the
<strong>OP</strong>en<strong>S</strong>erverless CLI.
+
+It is a task executor on steroids.
+
+- it embeds task, wsk and a lot of other utility commands (check with ops
-help)
+- automatically download and update command line tools, prerequisites and tasks
+- taskfiles are organized in commands and subcommands, hierarchically and are
powered by docopt
+- it supports plugins
+
+The predefined set of tasks are all you need to install and manage an
OpenServerless cluster.
+
+### Install with `go install`
+
+You install `ops` by building it from the official Apache sources with a Go
+compiler. You need [Go](https://go.dev/dl/) installed first.
+
+```bash
+go install github.com/apache/openserverless-cli/cmd/[email protected]
+```
+
+You can replace `0.9.0` with any other version you want to install, including
+unreleased ones — for example a snapshot such as
+`v0.9.0-2609031727.SNAPSHOT`. The available versions are the tags of the
+[openserverless-cli](https://github.com/apache/openserverless-cli/tags)
+repository.
+
+This installs `ops` into `$(go env GOPATH)/bin`. Make sure that directory is on
+your `PATH`:
+
+```bash
+export PATH="$PATH:$(go env GOPATH)/bin"
+```
+
+### Check the installation
+
+Once installed, check that `ops` is set up correctly:
+
+```bash
+$ ops -info
+Welcome to ops! Setting up...
+Cloning tasks...
+Tasks downloaded successfully
+ensuring prerequisite kubectl 1.33.1
+ensuring prerequisite kind 0.30.0
+ensuring prerequisite helm 3.18.0
+...
+OPS & OPS_CMD: /home/me/go/bin/ops
+OPS_VERSION: 0.9.0
+OPS_BRANCH: 0.9.0
+OPS_BIN: /home/me/.ops/linux-amd64/bin
+OPS_TMP: /home/me/.ops/tmp
+OPS_HOME: /home/me/.ops
+OPS_ROOT: /home/me/.ops/0.9.0/oplugins
+OPS_REPO: http://github.com/apache/openserverless-task
+OPS_PWD: /home/me
+OPS_TASKS: 7e523adb9af3f17ae221220e9c17bce31fd92090
+OPS_ROOT_PLUGIN: /home/me
+```
+
+The first run downloads what it needs — the tasks (its internal logic, a git
+clone of `OPS_REPO`) and the prerequisite binaries such as `kubectl`, `kind`
and
+`helm` — caching them under `~/.ops`. Later runs start immediately.
+
+Check that `OPS_REPO` is `http://github.com/apache/openserverless-task` and
that
+`OPS_BRANCH` matches the version you installed.
+
+Use `ops -t` to list the available tasks.
+
+## Create a local OpenServerless
+
+If you have [Docker](https://docs.docker.com/get-started/get-docker/)
installed,
+you can now create a complete OpenServerless on your own machine with a single
+command:
+
+```bash
+ops setup mini
+```
+
+This is the fastest way to get a working system, and the recommended starting
+point: it installs everything locally, so you can try OpenServerless without a
+cluster and without a cloud account.
+
+When it finishes, follow the [Quick Start](/docs/installation/quickstart/) to
+deploy your first action.
+
+To install on a real cluster instead — Kubernetes, K3s, MicroK8s, EKS, AKS, GKE
+and more — check the [prerequisites](/docs/installation/prereq/) and then the
+[installation guides](/docs/installation/install/).
+
+### Keeping it up to date
+
+`ops` will tell you when its tasks need updating:
+
+`ops -update`
+
+This command updates the OpenServerless "tasks" (its internal logic) to the
+latest version. This command should be also executed frequently, as the
+tasks are continuously evolving and expanding.
+
+`ops` will suggest when to update them (at least once a day).
+
+You normally just need to update the tasks but sometimes you also need
+to update `ops` itself. The system will detect when it is the case and
+tell you what to do.
+
+### Where to find more details:
+
+For more details, please visit the Github page of [Openserverless
Cli](https://github.com/apache/openserverless-cli)
diff --git a/content/en/docs/installation/install/_index.md
b/content/en/docs/installation/install/_index.md
index 54552bcc..b71e60e6 100644
--- a/content/en/docs/installation/install/_index.md
+++ b/content/en/docs/installation/install/_index.md
@@ -10,7 +10,7 @@ This page provides an overview of the installation process.
Please ensure you have:
-- [downloaded the installer](/docs/installation/download/)
+- [installed the CLI](/docs/installation/install-cli/)
- [satisfied the prerequisites](/docs/installation/prereq/)
- [configured your installation](/docs/installation/configure/)
diff --git a/content/en/docs/installation/install/cluster/_index.md
b/content/en/docs/installation/install/cluster/_index.md
index 61397bbb..f248b89b 100644
--- a/content/en/docs/installation/install/cluster/_index.md
+++ b/content/en/docs/installation/install/cluster/_index.md
@@ -14,7 +14,7 @@ Before installing, you need to:
- [Configure](/docs/installation/configure/) the installation
-- install [Download and install](/docs/installation/download/) OpenServerless
CLI, `ops`.
+- install [Download and install](/docs/installation/install-cli/)
OpenServerless CLI, `ops`.
### Installation
diff --git a/content/en/docs/installation/install/docker/_index.md
b/content/en/docs/installation/install/docker/_index.md
index 15674cd1..8fb5ff5d 100644
--- a/content/en/docs/installation/install/docker/_index.md
+++ b/content/en/docs/installation/install/docker/_index.md
@@ -16,7 +16,7 @@ Before installing, you need to:
- install [Docker](/docs/installation/prereq/docker/).
-- install [ops](/docs/installation/download/).
+- install [ops](/docs/installation/install-cli/).
Furthermore you will need a decent PC / Mac.
diff --git a/content/en/docs/installation/install/server/_index.md
b/content/en/docs/installation/install/server/_index.md
index 4fa6697d..e29bc1f9 100644
--- a/content/en/docs/installation/install/server/_index.md
+++ b/content/en/docs/installation/install/server/_index.md
@@ -14,7 +14,7 @@ development purposes.
Before installing, you need to:
-1. install the OpenServerless CLI [ops](/docs/installation/download/);
+1. install the OpenServerless CLI [ops](/docs/installation/install-cli/);
2. provision a [server running a Linux operating
system](/docs/installation/prereq/server/),
either a virtual machine or a physical server, and you know its IP address
diff --git a/content/en/docs/installation/prereq/kubernetes/eks/_index.md
b/content/en/docs/installation/prereq/kubernetes/eks/_index.md
index f5697ce4..7fdb25c2 100644
--- a/content/en/docs/installation/prereq/kubernetes/eks/_index.md
+++ b/content/en/docs/installation/prereq/kubernetes/eks/_index.md
@@ -9,7 +9,7 @@ cluster offered by the cloud provider [Amazon Web
Services](https://aws.amazon.com/).
You can create an EKS Cluster in Amazon AWS for installing using
-OpenServerless using [ops](/docs/installation/download/) as follows:
+OpenServerless using [ops](/docs/installation/install-cli/) as follows:
1. install `aws`, the [AWS CLI](#install-cli)
diff --git a/content/en/docs/installation/quickstart/_index.md
b/content/en/docs/installation/quickstart/_index.md
index 79c78ce6..04514964 100644
--- a/content/en/docs/installation/quickstart/_index.md
+++ b/content/en/docs/installation/quickstart/_index.md
@@ -19,7 +19,7 @@ apply the rule: "if everything fails, read the manual".
Start ensuring the prerequsites are satisfied:
-- [Download and install](/docs/installation/download/) `ops`, the
+- [Install](/docs/installation/install-cli/) `ops`, the
OpenServerless CLI, picking version suitable for your environment.
We support 64-bit versions of recent Windows, MacOS and major Linux
distributions.
diff --git a/content/en/docs/reference/references/advanced-cli/_index.md
b/content/en/docs/reference/references/advanced-cli/_index.md
index ed319e6b..ebf4490b 100644
--- a/content/en/docs/reference/references/advanced-cli/_index.md
+++ b/content/en/docs/reference/references/advanced-cli/_index.md
@@ -10,7 +10,7 @@ draft: false
OpenServerless offers a powerful command line interface named `ops` which
extends and embeds the OpenWhisk `wsk`.
-Download instructions are available [here](/docs/installation/download/).
+Download instructions are available [here](/docs/installation/install-cli/).
Let's see some advanced uses of `ops`.
diff --git a/content/en/openserverless-diagram.png
b/content/en/openserverless-diagram.png
index 4e39539e..fee8b81c 100644
Binary files a/content/en/openserverless-diagram.png and
b/content/en/openserverless-diagram.png differ
diff --git a/content/en/openserverless-diagram.webp
b/content/en/openserverless-diagram.webp
index 184dc376..92b6f42f 100644
Binary files a/content/en/openserverless-diagram.webp and
b/content/en/openserverless-diagram.webp differ
diff --git a/hugo.yaml b/hugo.yaml
index a69bf381..2609593f 100644
--- a/hugo.yaml
+++ b/hugo.yaml
@@ -199,32 +199,20 @@ params:
links:
# End user relevant links. These will show up on left side of footer and
in the community page if you have one.
user:
- - name: Developer mailing list
- url: mailto:[email protected]
+ - name: Mailing list
+ url: https://lists.apache.org/[email protected]
icon: fa fa-envelope
- desc: Discussion and help from your fellow users
- - name: X.com
- url: https://x.com/open_serverless
- icon: fab fa-x-twitter
- desc: Follow us on Twitter to get the latest news!
- - name: Reddit
- url: https://reddit.com/r/openserverless
- icon: fab fa-reddit
- desc: Practical questions and curated answers
+ desc: "The primary channel - read the archives and subscribe to
[email protected]"
+ - name: Slack
+ url: https://the-asf.slack.com/archives/C07B6K5R3F0
+ icon: fab fa-slack
+ desc: "The #openserverless channel on the Apache Software Foundation
Slack"
# Developer relevant links. These will show up on right side of footer and
in the community page if you have one.
developer:
- name: GitHub
url: https://github.com/apache/openserverless
icon: fab fa-github
- desc: Development takes place here!
- - name: Discord
- url: https://discord.com/invite/PkD7CcHgGP
- icon: fab fa-discord
- desc: A public discor server to discuss everything about OpenServerless
- - name: Slack
- url: https://the-asf.slack.com/archives/C07B6K5R3F0
- icon: fab fa-slack
- desc: Chat with other project developers
+ desc: "Sources and issues - development takes place here!"
module:
diff --git a/i18n/en.toml b/i18n/en.toml
new file mode 100644
index 00000000..a5099244
--- /dev/null
+++ b/i18n/en.toml
@@ -0,0 +1,36 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+# Overrides of the Docsy theme strings used by the community page.
+
+[community_join]
+other = "Join the {{ .Site.Title }} community"
+
+[community_introduce]
+other = "{{ .Site.Title }} is an open source project of the Apache Software
Foundation, built by a community that anyone can join. Everything happens in
the open. The mailing list is where decisions are made, so subscribing to it is
the first step."
+
+[community_learn]
+other = "Talk to us"
+
+[community_using]
+other = "The mailing list is the primary channel of the project. For quick
questions there is also a channel on the ASF Slack:"
+
+[community_develop]
+other = "Code and contribute"
+
+[community_contribute]
+other = "Sources, issues and pull requests:"
