Over the past year, we’ve been rapidly expanding Jina AI Cloud, starting with our Executor Hub, and now encompassing DocumentArray storage, hosted Flows and cloud apps.

Jina AI Cloud：https://cloud.jina.ai/

That’s a lot of stuff to manage! We’re introducing user namespaces to make things easier for all our users.

Namespace

Previously, if Alice and Bob both wanted to push a DocumentArray called fashion-mnist, whoever pushed first would get the name. That means Bob might have to go with fashion-mnist2 or similar. With more people using Jina AI Cloud, naming conflicts could become commonplace.

With user namespaces, both Alice and Bob can have their own fashion_mnist DocumentArrays (or Executors with the same name) with no fear of naming conflicts.

The new namespace apply to two important resources inside Jina AI ecosystem: DocumentArray and Executor.

Schema

Moving forwards, names for DocumentArrays and Hub Executors will follow the new schema, namespace/resource:

💡Note that Executors now use jinaai:// as the prefix (not jinahub://) and no longer need secrets (as you already logged in).

Access scope

For both DocumentArray and Executor, the user enjoys the following accessibility:

Does this break anything?

• There are no breaking changes for existing Executors on Executor Hub.
• You can still pull old DocumentArrays by their original name, but you can’t update them. Newly-pushed DocumentArrays must follow the username/da-name scheme.

Managing your resources under the namespace

Manage DocumentArrays

1. Create a Jina AI account at cloud.jina.ai.

1. Upgrade docarray to >=0.19.1 version with pip install -U docarray.

2. Log in via docarray.login() and start pushing and pulling DocumentArrays:
   

from docarray import DocumentArray

docarray.login()  # log in as 'alice'

docs = DocumentArray.pull('alice/fashion_mnist')

docs.push('alice/fashion_mnist_updated')

1. Manage your pushed DocumentArrays on Jina AI Cloud in the "Storage" tab:

Manage Executors

Upgrade jina to the latest version with pip install -U jina.

1.Create a Jina AI account at cloud.jina.ai.
2.Use an existing Executor in your Flow (in Python):

from jina import Flow

flow = Flow().add(uses='jinaai+docker://alice/MyExecutor')  # note jinaai

with flow:
    ...

3.Or push your own Executor to Executor Hub (from the CLI):

jina auth login
jina hub push MyExecutor

4.Manage your Executors on Executor Hub on the "Executors" tab: