Manual book Revised completely #76

Merged
mik-tf merged 14 commits from development_manual2 into development 2024-05-14 22:14:07 +00:00
7 changed files with 57 additions and 4 deletions
Showing only changes of commit b723cf3c70 - Show all commits

View File

@ -202,6 +202,7 @@
- [Web Gateway](system_administrators/terraform/resources/terraform_vm_gateway.md)
- [Kubernetes Cluster](system_administrators/terraform/resources/terraform_k8s.md)
- [ZDB](system_administrators/terraform/resources/terraform_zdb.md)
- [Zlogs](system_administrators/terraform/resources/terraform_zlogs.md)
- [Quantum Safe Filesystem](system_administrators/terraform/resources/terraform_qsfs.md)
- [QSFS on Micro VM](system_administrators/terraform/resources/terraform_qsfs_on_microvm.md)
- [QSFS on Full VM](system_administrators/terraform/resources/terraform_qsfs_on_full_vm.md)
@ -248,6 +249,7 @@
- [Cancel Contracts](system_administrators/advanced/cancel_contracts.md)
- [Contract Bills Reports](system_administrators/advanced/contract_bill_report.md)
- [Listing Free Public IPs](system_administrators/advanced/list_public_ips.md)
- [Cloud Console](system_administrators/advanced/cloud_console.md)
- [Redis](system_administrators/advanced/grid3_redis.md)
- [IPFS](system_administrators/advanced/ipfs/ipfs_toc.md)
- [IPFS on a Full VM](system_administrators/advanced/ipfs/ipfs_fullvm.md)

View File

@ -8,6 +8,7 @@ In this section, we delve into sophisticated topics and powerful functionalities
- [Cancel Contracts](cancel_contracts.md)
- [Contract Bills Reports](contract_bill_report.md)
- [Listing Free Public IPs](list_public_ips.md)
- [Cloud Console](cloud_console.md)
- [Redis](grid3_redis.md)
- [IPFS](ipfs_toc.md)
- [IPFS on a Full VM](ipfs_fullvm.md)

View File

@ -0,0 +1,33 @@
<h1> Cloud Console </h1>
<h2>Table of Contents</h2>
- [Introduction](#introduction)
- [Overview](#overview)
- [Connect to Cloud Console](#connect-to-cloud-console)
---
## Introduction
Cloud console is a tool to view machine logging and interact with the machine you have deployed. We show the basics of cloud-console and how to access it via a browser during deployment.
## Overview
Cloud console always runs on the machine's private network ip and port number equla to `20000 +last octect` of machine private IP. For example if the machine ip is `10.20.2.2/24`, this means that `cloud-console` is running on `10.20.2.1:20002`.
For the cloud-console to run we need to start the cloud-hypervisor with option "--serial pty" instead of tty, this allows us to interact with the vm from another process, `cloud-console` in our case.
## Connect to Cloud Console
You can easily connect to cloud console on the TFGrid.
- Deploy a VM on the TFGrid with the WireGuard network
- Set the WireGuard configuration file
- Start the WireGuard connection:
```
wg-quick up wireguard.conf
```
- Go to your browser with the network router IP `10.20.2.1:20002` to access cloud console.
> Note: You might need to create a user/password in the VM first before connecting to cloud-console if the image used does not have a default user.

View File

@ -32,6 +32,7 @@ For complementary information on ThreeFold grid and its cloud component, refer t
- [Web Gateway](terraform_vm_gateway.md)
- [Kubernetes Cluster](terraform_k8s.md)
- [ZDB](terraform_zdb.md)
- [Zlogs](terraform_zlogs.md)
- [Quantum Safe Filesystem](terraform_qsfs.md)
- [QSFS on Micro VM](terraform_qsfs_on_microvm.md)
- [QSFS on Full VM](terraform_qsfs_on_full_vm.md)
@ -78,6 +79,7 @@ For complementary information on ThreeFold grid and its cloud component, refer t
- [Cancel Contracts](cancel_contracts.md)
- [Contract Bills Reports](contract_bill_report.md)
- [Listing Free Public IPs](list_public_ips.md)
- [Cloud Console](cloud_console.md)
- [Redis](grid3_redis.md)
- [IPFS](ipfs_toc.md)
- [IPFS on a Full VM](ipfs_fullvm.md)

View File

@ -7,6 +7,7 @@
- [Web Gateway](./terraform_vm_gateway.html)
- [Kubernetes Cluster](./terraform_k8s.html)
- [ZDB](./terraform_zdb.html)
- [Zlogs](./terraform_zlogs.md)
- [Quantum Safe Filesystem](terraform_qsfs.md)
- [QSFS on Micro VM](terraform_qsfs_on_microvm.md)
- [QSFS on Full VM](terraform_qsfs_on_full_vm.md)

View File

@ -1,10 +1,21 @@
# Zlogs
<h1> Zlogs </h1>
<h2>Table of Contents</h2>
- [Introduction](#introduction)
- [Using Zlogs](#using-zlogs)
- [Creating a server](#creating-a-server)
- [Streaming logs](#streaming-logs)
---
## Introduction
Zlogs is a utility that allows you to stream VM logs to a remote location. You can find the full description [here](https://github.com/threefoldtech/zos/tree/main/docs/manual/zlogs)
## Using Zlogs
In terraform, a vm has a zlogs field, this field should contain a list of target URLs to stream logs to.
In Terraform, a vm has a zlogs field, this field should contain a list of target URLs to stream logs to.
Valid protocols are: `ws`, `wss`, and `redis`.
@ -104,5 +115,4 @@ asyncio.run(main())
```
exec: sh -c "echo 'to be streamed'"
log: stdout
```
```

View File

@ -13,7 +13,11 @@
- [Web Gateway](terraform_vm_gateway.md)
- [Kubernetes Cluster](terraform_k8s.md)
- [ZDB](terraform_zdb.md)
- [Zlogs](terraform_zlogs.md)
- [Quantum Safe Filesystem](terraform_qsfs.md)
- [QSFS on Micro VM](terraform_qsfs_on_microvm.md)
- [QSFS on Full VM](terraform_qsfs_on_full_vm.md)
- [CapRover](terraform_caprover.md)
- [QSFS on Micro VM](terraform_qsfs_on_microvm.md)
- [QSFS on Full VM](terraform_qsfs_on_full_vm.md)
- [CapRover](terraform_caprover.md)