Administering Streams Instances¶
Create, manage, and delete Streams instances with the extension.
Note
All operations are performed in the Streams Explorer view. Click on the icon in the Activity Bar to open the view.
Managing instance lifecycles¶
Creating an instance¶
- Click the (Add Instance) icon in the Instances section
- Provide a name for the instance and configure any other fields in the form
- Click the Create Instance button
Starting an instance¶
- Hover over the name of the stopped instance you want to start
- Click the (Start Instance) icon
Stopping an instance¶
- Hover over the running instance you want to stop
- Click the (Stop Instance) icon
- Click Yes in the dialog box to confirm operation
Deleting an instance¶
- Hover over the stopped instance you want to delete
- Click the (Remove Instance) icon
- Click Yes in the dialog box to confirm operation
Setting an instance as the default¶
If a Streams domain only has one instance, the extension will automatically mark the instance as the default. If a domain has multiple instances, you must set an instance as the default for operations:
- Hover over the name of the instance you want to make the default
- Click the (Set Instance as Default) icon
Managing environment variables¶
Applications submitted to an instance may use environment variables to get information or control behavior. You can manage environment variables and their values available to applications in the Streams Explorer view.
Danger
Do not store credentials or sensitive connection information in environment variables. Use application configurations instead.
Create an environment variable¶
- Hover over the Environment Variables item under the instance you want to modify
- Click the (Add Environment Variable) icon
- Fill in the name and value of the environment variable
- Click the Add button
Modify an environment variable¶
- Hover over the environment variable you want to change
- Click the (Update Environment Variable) icon
- Update the variable name or value
- Click the Update button
Remove an environment variable¶
- Hover over the environment variable you want to remove
- Click the (Remove Environment Variable) icon
- Click Yes in the dialog box to confirm operation
Managing application configurations¶
Application configurations (app configs) are sets of securely stored properties recommended for applications to receive sensitive information. You can manage app configs and their properties available to applications in the Streams Explorer view.
Create an app config¶
- Hover over the Application Configurations item under the instance you want to modify
- Click the (Add Application Configuration) icon
- Fill in the name and properties
- Click the Add button
Modify an app config¶
- Hover over the app config you want to change
- Click the (Update Application Configuration) icon
- Update the name, description, or properties
- Click the Update button
Remove an app config¶
- Hover over the app config you want to remove
- Click the (Remove Application Configuration) icon
- Click Yes in the dialog box to confirm operation
Opening Streams Console¶
While the extension provides a lot of administration workflows, you can open the Streams Console (Web UI) from the Streams Explorer view for additional workflows:
- Hover over the instance
- Click the (Open Streams Console) icon
- Click Open in the dialog box to confirm