Commit 5154f028 authored by Viktor Nagy's avatar Viktor Nagy Committed by Marcia Ramos

Documentation for 1-liner installation of `agentk`

parent 59255eb7
...@@ -223,7 +223,31 @@ the Agent in subsequent steps. You can create an Agent record either: ...@@ -223,7 +223,31 @@ the Agent in subsequent steps. You can create an Agent record either:
[Getting started with the GraphQL API page](../../../api/graphql/getting_started.md), [Getting started with the GraphQL API page](../../../api/graphql/getting_started.md),
or the [GraphQL Explorer](https://gitlab.com/-/graphql-explorer). or the [GraphQL Explorer](https://gitlab.com/-/graphql-explorer).
### Create the Kubernetes secret ### Install the Agent into the cluster
Next, install the in-cluster component of the Agent.
#### One-liner installation
Replace the value of `agent-token` below with the token received from the previous step. Also, replace `kas-address` with the configured access of the Kubernetes Agent Server:
```shell
docker run --rm registry.gitlab.com/gitlab-org/cluster-integration/gitlab-agent/cli:latest generate --agent-token=your-agent-token --kas-address=wss://kas.gitlab.example.com --agent-version latest | kubectl apply -f -
```
To find out the various options the above Docker container supports, run:
```shell
docker run --rm -it registry.gitlab.com/gitlab-org/cluster-integration/gitlab-agent/cli:latest generate --help
```
#### Advanced installation
For more advanced configurations, we recommend to use [the `kpt` based installation method](https://gitlab.com/gitlab-org/cluster-integration/gitlab-agent/-/tree/master/build/deployment/gitlab-agent).
Otherwise, you can follow below for fully manual, detailed installation steps.
##### Create the Kubernetes secret
After generating the token, you must apply it to the Kubernetes cluster. After generating the token, you must apply it to the Kubernetes cluster.
...@@ -239,9 +263,7 @@ After generating the token, you must apply it to the Kubernetes cluster. ...@@ -239,9 +263,7 @@ After generating the token, you must apply it to the Kubernetes cluster.
kubectl create secret generic -n <YOUR-DESIRED-NAMESPACE> gitlab-agent-token --from-literal=token='YOUR_AGENT_TOKEN' kubectl create secret generic -n <YOUR-DESIRED-NAMESPACE> gitlab-agent-token --from-literal=token='YOUR_AGENT_TOKEN'
``` ```
### Install the Agent into the cluster The following example file contains the
Next, install the in-cluster component of the Agent. This example file contains the
Kubernetes resources required for the Agent to be installed. You can modify this Kubernetes resources required for the Agent to be installed. You can modify this
example [`resources.yml` file](#example-resourcesyml-file) in the following ways: example [`resources.yml` file](#example-resourcesyml-file) in the following ways:
...@@ -288,7 +310,7 @@ NAMESPACE NAME READY STATUS RESTARTS AG ...@@ -288,7 +310,7 @@ NAMESPACE NAME READY STATUS RESTARTS AG
gitlab-agent gitlab-agent-77689f7dcb-5skqk 1/1 Running 0 51s gitlab-agent gitlab-agent-77689f7dcb-5skqk 1/1 Running 0 51s
``` ```
#### Example `resources.yml` file ##### Example `resources.yml` file
```yaml ```yaml
apiVersion: v1 apiVersion: v1
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment