Skip to content

Commit 055557d

Browse files
peer review
1 parent 27b9311 commit 055557d

File tree

1 file changed

+13
-14
lines changed

1 file changed

+13
-14
lines changed

docs/continuous-delivery/onboard-cd/cd-concepts/services-and-environments-overview.md

+13-14
Original file line numberDiff line numberDiff line change
@@ -17,14 +17,14 @@ If you are new to Harness, please review [Harness key concepts](../../../getting
1717
Services represent your microservices and other workloads. Each service contains a **Service Definition** that defines your deployment artifacts, manifests or specifications, configuration files, and service-specific variables.
1818

1919
You can create services from:
20-
* Account level
21-
* Organization level
20+
* An account
21+
* An Organization
2222
* Within a pipeline
2323
* Outside a pipeline
2424

2525
### Creating services at an account or organization level
2626

27-
You can create a service at an account or organization level from the Harness UI, using APIs or Terraform.
27+
You can create a service at an account or organization level from the Harness UI using APIs or Terraform.
2828

2929
```mdx-code-block
3030
import Tabs from '@theme/Tabs';
@@ -34,7 +34,7 @@ import TabItem from '@theme/TabItem';
3434
<Tabs>
3535
<TabItem value="Harness UI" label="Harness UI">
3636
```
37-
To create a service at an account and organization level, select **Services** in **Organization Resources**.
37+
To create a service at an account or organization level, go to **Organization Resources** **>Services**.
3838

3939
Creating an account level service enables you to manage the service globally across the organizations and projects within the account.
4040

@@ -150,7 +150,7 @@ service:
150150
```
151151
For information about creating a service API, go to [create a service](https://apidocs.harness.io/tag/Services#operation/createServiceV2).
152152

153-
The `orgIdentifier` and `projectIdentifier` field definitions are optional, and depend on where you want to create the service. For example, if you create a service at an account level, you will not need org or project identifiers in the post api call payload.
153+
The `orgIdentifier` and `projectIdentifier` field definitions are optional, and depend on where you want to create the service. For example, if you create a service at an account level, you will not need org or project identifiers in the post API call payload.
154154

155155
```mdx-code-block
156156
</TabItem>
@@ -235,32 +235,31 @@ To create a service from outside of a pipeline, you use **Services** in the navi
235235

236236
### Creating services inside a pipeline
237237

238-
To create a service from inside of a pipeline, select **New Service** in the **Services** tab of a new CD stage.
238+
To create a service from inside of a pipeline, select the **Services** tab of a new CD stage, then select **New Service**.
239239

240240
![](./static/services-and-environments-overview-10.png)
241241

242242
Once the service and its service definition are saved, you can select it in any pipeline.
243243

244244
When you select the service in a pipeline, you can select **Edit Service** to edit its **Service Definition**.
245245

246-
When you create the new service you define its **Service Definition**. For example, Kubernetes **Service Definition** with a Kubernetes manifest and Docker artifact.
246+
When you create the new service you define its **Service Definition**. For example, a Kubernetes **Service Definition** with a Kubernetes manifest and Docker artifact.
247247

248248
## Environments
249249

250250
Environments represent your deployment targets (QA, Prod, etc). Each environment contains one or more **Infrastructure Definitions** that list your target clusters, hosts, namespaces, etc.
251251

252252
You can create environments from:
253-
* Account level
254-
* Organization level
253+
* An Account
254+
* An Organization
255255
* Within a pipeline
256256
* Outside a pipeline
257257

258258
Next you can define all of its settings:
259259

260260
* **Infrastructure Definitions:** represent one or more environment infrastructures.
261-
* Infrastructure definitions are the actual clusters, hosts, etc., where Harness deploys a service.
262-
* For example, you might have a QA environment with separate Kubernetes clusters (infrastructure definitions) for each service you want to test.
263-
* You can add multiple infrastructure definitions to a single environment and select one when you add the environment to a stage.
261+
* Infrastructure definitions are the actual clusters, hosts, etc., where Harness deploys a service. For example, you might have a QA environment with separate Kubernetes clusters (infrastructure definitions) for each service you want to test.
262+
* You can add multiple infrastructure definitions to a single environment and select an infrastructure definition when you add the environment to a stage.
264263
* **Configuration:** the default environment configuration, including variables, manifests, specifications, and config files that will be used every time the environment is used in a stage.
265264
* **Service Overrides:** override specific services. You select a service and define what will be overridden whenever that Service is deployed to this environment.
266265
* **GitOps Clusters:** adding Harness GitOps clusters to an environment lets you select them as the deployment target in stages. For more information on Harness GitOps, go to [Harness GitOps Basics](../../cd-gitops/harness-git-ops-basics.md).
@@ -279,7 +278,7 @@ import TabItem2 from '@theme/TabItem';
279278
<TabItem2 value="Harness UI" label="Harness UI">
280279
```
281280

282-
To create an environment at an account and organization level, select **Environments** in **Organization Resources**.
281+
To create an environment at an account or organization level, go to **Organization Resources** **>Environments**.
283282

284283
![](./static/create-environments-from-account-level.png)
285284

@@ -387,7 +386,7 @@ For information about creating an environment API, go to [create an environment]
387386

388387
For information about creating infrastructure definiton API, go to [create an infrastructure in an environment](https://apidocs.harness.io/tag/Infrastructures#operation/createInfrastructure).
389388

390-
The `orgIdentifier` and `projectIdentifier` field definitions are optional, and depend on where you want to create the environment. For example, if you create an environment at an account level, you will not need org or project identifiers in the post api call payload.
389+
The `orgIdentifier` and `projectIdentifier` field definitions are optional, and depend on where you want to create the environment. For example, if you create an environment at an account level, you will not need org or project identifiers in the post API call payload.
391390

392391
```mdx-code-block
393392
</TabItem2>

0 commit comments

Comments
 (0)