Skip to content

Commit

Permalink
Merge pull request #466 from Qovery/feat/cli_access_cluster
Browse files Browse the repository at this point in the history
Access your managed cluster with CLI
  • Loading branch information
jul-dan authored Sep 4, 2024
2 parents 57203e8 + 007cf09 commit b7f2c66
Show file tree
Hide file tree
Showing 2 changed files with 77 additions and 1 deletion.
40 changes: 39 additions & 1 deletion website/docs/using-qovery/interface/cli.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_on: "2024-08-12"
last_modified_on: "2024-09-04"
title: CLI
description: How to use the Qovery CLI (Command Line Interface)
---
Expand Down Expand Up @@ -625,6 +625,44 @@ You can list the organization's projects by using the following command:
qovery project list
```

## Access your Qovery-managed cluster

To access your Qovery managed cluster, follow these steps:

1. **Export your kubeconfig file** by running the command below, replacing `<your-cluster_id>` with your actual cluster ID:

```bash
qovery cluster kubeconfig --cluster-id <your-cluster_id>
```

2. **Set the KUBECONFIG environment variable** to the path of the kubeconfig file obtained from the previous command:

```bash
export KUBECONFIG=<path_to_kubeconfig_file>
```

3. You can now use tools like `k9s` or `kubectl` to access and manage your cluster:

**Using k9s**

Launch the k9s terminal UI to interact with your Kubernetes cluster:

```bash
k9s
```

**Using kubectl**

Here are a few examples of common kubectl commands:

```bash
kubectl get pods #List all pods in the default namespace
```

```bash
kubectl describe pod <pod_name> #Get detailed information about a specific pod
```

## Managing the Deployment Pipeline

In the following sections we will describe how to modify the Deployment Pipeline.
Expand Down
38 changes: 38 additions & 0 deletions website/docs/using-qovery/interface/cli.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -460,6 +460,44 @@ You can list the organization's projects by using the following command:
qovery project list
```

## Access your Qovery-managed cluster

To access your Qovery managed cluster, follow these steps:

1. **Export your kubeconfig file** by running the command below, replacing `<your-cluster_id>` with your actual cluster ID:

```bash
qovery cluster kubeconfig --cluster-id <your-cluster_id>
```

2. **Set the KUBECONFIG environment variable** to the path of the kubeconfig file obtained from the previous command:

```bash
export KUBECONFIG=<path_to_kubeconfig_file>
```

3. You can now use tools like `k9s` or `kubectl` to access and manage your cluster:

**Using k9s**

Launch the k9s terminal UI to interact with your Kubernetes cluster:

```bash
k9s
```

**Using kubectl**

Here are a few examples of common kubectl commands:

```bash
kubectl get pods #List all pods in the default namespace
```

```bash
kubectl describe pod <pod_name> #Get detailed information about a specific pod
```

## Managing the Deployment Pipeline

In the following sections we will describe how to modify the Deployment Pipeline.
Expand Down

0 comments on commit b7f2c66

Please sign in to comment.