Skip to content

Commit dd86d21

Browse files
committed
update CICD and VSCode related docs
1 parent cc6dfe9 commit dd86d21

File tree

5 files changed

+24
-34
lines changed

5 files changed

+24
-34
lines changed

articles/stream-analytics/cicd-overview.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,31 +2,28 @@
22
title: Continuous integration and deployment for Azure Stream Analytics
33
description: This article gives an overview of a continuous integration and deployment (CI/CD) pipeline for Azure Stream Analytics.
44
services: stream-analytics
5-
author: su-jie
6-
ms.author: sujie
5+
author: alexlzx
6+
ms.author: zhenxilin
77
ms.service: stream-analytics
88
ms.topic: how-to
9-
ms.date: 9/22/2020
9+
ms.date: 12/27/2022
1010
---
1111

1212
# Continuous integration and deployment (CI/CD) for Azure Stream Analytics
1313

14-
You can deploy your Azure Stream Analytics job continuously by using source control integration. Source control integration enables a workflow in which a code update triggers a resource deployment to Azure. This article outlines the basic steps for creating a continuous integration and deployment (CI/CD) pipeline.
14+
You can build and deploy your Azure Stream Analytics job continuously using a source control integration. Source control integration creates a workflow in which any code updates would trigger a resource deployment to Azure. This article outlines the basic steps for creating a continuous integration and continuous delivery (CI/CD) pipeline.
1515

1616
If you're new to Azure Stream Analytics, get started with the [Azure Stream Analytics quickstart](stream-analytics-quick-create-portal.md).
1717

1818
## Create a CI/CD pipeline
1919

20-
Follow the steps in this guide to create a CI/CD pipeline for Stream Analytics.
20+
Follow the steps to create a CI/CD pipeline for your Stream Analytics project:
2121

22-
1. Develop an Azure Stream Analytics query.
22+
1. Create a Stream Analytics project using VSCode.
2323

24-
Use Azure Stream Analytics tools for [Visual Studio Code](./quick-create-visual-studio-code.md) or [Visual Studio](stream-analytics-quick-create-vs.md) to [develop and test queries locally](develop-locally.md). You can also [export an existing job](visual-studio-code-explore-jobs.md#export-a-job-to-a-local-project) to a local project.
24+
Use the ASA Tools extension for [Visual Studio Code](./quick-create-visual-studio-code.md) to [develop and test queries locally](develop-locally.md). You can also [export an existing job](visual-studio-code-explore-jobs.md#export-a-job-to-a-local-project) to your local machine.
2525

26-
> [!NOTE]
27-
> We strongly recommend using [**Stream Analytics tools for Visual Studio Code**](./quick-create-visual-studio-code.md) for best local development experience. There are known feature gaps in Stream Analytics tools for Visual Studio 2019 (version 2.6.3000.0) and it won't be improved going forward.
28-
29-
2. Commit your Azure Stream Analytics projects to your source control system, like a Git repository.
26+
2. Commit your Stream Analytics project to your source control system, like a Git repository.
3027

3128
3. Use [Azure Stream Analytics CI/CD tools](cicd-tools.md) to build the projects and generate Azure Resource Manager templates for the deployment.
3229

articles/stream-analytics/cicd-tools.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,16 @@
22
title: Automate builds, tests, and deployments of an Azure Stream Analytics job using CI/CD tools
33
description: This article describes how to use Azure Stream Analytics CI/CD tools to auto build, test, and deploy an Azure Stream Analytics project.
44
services: stream-analytics
5-
author: su-jie
6-
ms.author: sujie
5+
author: alexlzx
6+
ms.author: zhenxilin
77
ms.service: stream-analytics
88
ms.topic: how-to
9-
ms.date: 06/29/2021
9+
ms.date: 12/27/2022
1010
---
1111

1212
# Automate builds, tests, and deployments of an Azure Stream Analytics job using CI/CD tools
1313

14-
You can use the Azure Stream Analytics CI/CD npm package to automatically build, test, and deploy your Azure Stream Analytics Visual Studio Code or Visual Studio projects. The projects can be created using development tools or they can be exported from existing Stream Analytics jobs. This article describes how to use the npm package with any CI/CD system. For deployment with Azure Pipelines, see [Use Azure DevOps to create a CI/CD pipeline for a Stream Analytics job](set-up-cicd-pipeline.md).
14+
You can use the Azure Stream Analytics CI/CD npm package to automatically build, test, and deploy your Azure Stream Analytics projects using Visual Studio Code. You can create a new Stream Analytics project using the ASA Tools extension for Visual Studio Code or export an existing Stream Analytics job from Azure. This article describes how to use the npm package with any CI/CD system. For deployment with Azure Pipelines, see [Use Azure DevOps to create a CI/CD pipeline for a Stream Analytics job](set-up-cicd-pipeline.md).
1515

1616
## Installation
1717

Lines changed: 5 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
title: Develop and debug Azure Stream Analytics jobs locally
33
description: Learn how to develop and test Azure Stream Analytics jobs on your local computer before you run them in Azure portal.
4-
ms.author: sujie
5-
author: su-jie
4+
ms.author: zhenxilin
5+
author: alexlzx
66
ms.topic: conceptual
7-
ms.date: 03/31/2020
7+
ms.date: 12/27/2022
88
ms.service: stream-analytics
99
---
1010

1111
# Develop and debug Azure Stream Analytics jobs locally
1212

13-
While you're able to create and test Azure Stream Analytics jobs in the Azure portal, many developers prefer a local development experience. Stream Analytics makes it easy to use your favorite code editor and development tools to create and test jobs with live event streams from Azure Event Hub, IoT Hub, and Blob Storage using a fully functioned single node local runtime. You can also submit jobs to Azure directly from your local development environment.
13+
Apart from creating and developing an Azure Stream Analytics job in the Azure portal, you can set up a Stream Analytics job using a developer tool on your computer. Azure Stream Analytics (ASA) allows you to use your favorite code editor e.g. Visual Studio Code to build and test query locally with live data streams from Azure Event Hub, IoT Hub, Blob Storage and other Azure resources. The ASA developer tool creates a fully functional node in local runtime to run your Stream Analytics job. You can also submit your local Stream Analytics jobs to Azure and change the job running status. This's a convenient way to build, test and manage your Stream Analytics jobs.
1414

1515
## Local development environments
1616

@@ -21,15 +21,9 @@ The environments in the following table support local development:
2121
|Environment |Description |
2222
|-----------------------------------------|------------|
2323
|[Visual Studio Code](visual-studio-code-explore-jobs.md)| The [Azure Stream Analytics Tools extension](https://marketplace.visualstudio.com/items?itemName=ms-bigdatatools.vscode-asa) for Visual Studio Code allows you to author, manage, test your Stream analytics job both locally and in the cloud with rich IntelliSense and native source control. Supports development on Linux, MacOS and Windows. To learn more, see [Create an Azure Stream Analytics job in Visual Studio Code](quick-create-visual-studio-code.md). The extension also supports [Visual Studio Codespaces](https://visualstudio.microsoft.com/services/visual-studio-codespaces/) which is a cloud-hosted dev environment.|
24-
|[Visual Studio 2019](stream-analytics-tools-for-visual-studio-install.md) |Stream Analytics Tools is part of the Azure development and Data storage and processing workloads in Visual Studio. You can use Visual Studio to write custom C# user-defined functions and deserializers. To learn more, see [Create an Azure Stream Analytics job by using Visual Studio](stream-analytics-quick-create-vs.md).|
2524
|[Command prompt or terminal](stream-analytics-tools-for-visual-studio-cicd.md)|The Azure Stream Analytics CI/CD NuGet package provides tools for Visual studio project build, local testing on an arbitrary machine. The Azure Stream Analytics CI/CD npm package provides tools for Visual Studio Code project builds (which generates an Azure Resource Manager template) on an arbitrary machine.|
2625

27-
> [!NOTE]
28-
> We strongly recommend using [**Stream Analytics tools for Visual Studio Code**](./quick-create-visual-studio-code.md) for best local development experience. There are known feature gaps in Stream Analytics tools for Visual Studio 2019 (version 2.6.3000.0) and it won't be improved going forward.
29-
3026
## Next steps
3127

3228
* [Test Stream Analytics queries locally with sample data using Visual Studio Code](visual-studio-code-local-run.md)
33-
* [Test Stream Analytics queries locally against live stream input by using Visual Studio Code](visual-studio-code-local-run-live-input.md)
34-
* [Test Stream Analytics queries locally with Visual Studio](stream-analytics-vs-tools-local-run.md)
35-
* [Test live data locally using Azure Stream Analytics tools for Visual Studio](stream-analytics-live-data-local-testing.md)
29+
* [Test Stream Analytics queries locally against live stream input by using Visual Studio Code](visual-studio-code-local-run-live-input.md)

articles/stream-analytics/set-up-cicd-pipeline.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,11 @@
22
title: Use Azure DevOps to create a CI/CD pipeline for a Stream Analytics job
33
description: This article describes how to set up a continuous integration and deployment (CI/CD) pipeline for an Azure Stream Analytics job in Azure DevOps
44
services: stream-analytics
5-
author: su-jie
6-
ms.author: sujie
7-
5+
author: alexlzx
6+
ms.author: zhenxilin
87
ms.service: stream-analytics
98
ms.topic: how-to
10-
ms.date: 09/10/2020
9+
ms.date: 12/27/2022
1110
---
1211

1312
# Use Azure DevOps to create a CI/CD pipeline for a Stream Analytics job

articles/stream-analytics/visual-studio-code-local-run.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
title: Test an Azure Stream Analytics job locally with sample data using Visual Studio Code
33
description: How to test queries locally with sample data using Azure Stream Analytics Tools for Visual Studio Code.
44
ms.service: stream-analytics
5-
author: su-jie
6-
ms.author: sujie
7-
ms.date: 11/10/2019
5+
author: alexlzx
6+
ms.author: zhenxilin
7+
ms.date: 12/27/2022
88
ms.topic: how-to
99
---
1010

1111
# Test Stream Analytics queries locally with sample data using Visual Studio Code
1212

13-
You can use Azure Stream Analytics tools for Visual Studio Code to test your Stream Analytics jobs locally with sample data. You can find the query results in JSON files in the **LocalRunOutputs** folder of your project.
13+
You can use Azure Stream Analytics tools for Visual Studio Code to test your Stream Analytics jobs locally with sample data. You output results can be found as JSON files in the **LocalRunOutputs** folder of your project.
1414

1515
For more information, see [Overview of local Stream Analytics runs in Visual Studio Code with ASA Tools](visual-studio-code-local-run-all.md).
1616

0 commit comments

Comments
 (0)