fix: add openim server deploy (#1036)

* fix: add openim server deploy Signed-off-by: Xinwei Xiong(cubxxw-openim) <3293172751nss@gmail.com> * feat: add openim im ctl Signed-off-by: Xinwei Xiong(cubxxw-openim) <3293172751nss@gmail.com> * feat: add more deployment docs Signed-off-by: Xinwei Xiong(cubxxw-openim) <3293172751nss@gmail.com> * feat: add openim save images and release Signed-off-by: Xinwei Xiong(cubxxw-openim) <3293172751nss@gmail.com> * build: set IBM sarama and set k8s deployment helm Signed-off-by: Xinwei Xiong(cubxxw-openim) <3293172751nss@gmail.com> * fix: add openim code fix Signed-off-by: Xinwei Xiong(cubxxw-openim) <3293172751nss@gmail.com> * fix: add openim code fix Signed-off-by: Xinwei Xiong(cubxxw-openim) <3293172751nss@gmail.com> --------- Signed-off-by: Xinwei Xiong(cubxxw-openim) <3293172751nss@gmail.com>
2026-05-12 04:55:59 +08:00 · 2023-09-07 17:38:09 +08:00
parent de50331d7a
commit da8912121f
44 changed files with 2970 additions and 282 deletions
@@ -0,0 +1,49 @@
+# OpenIM `man` Module README
+
+Welcome to the `man` module of OpenIM, the comprehensive guide for using OpenIM's range of powerful commands. Here, you'll find in-depth details for each command, its options, and examples to help you harness the full power of the OpenIM suite.
+
+## Overview
+
+OpenIM is a robust instant messaging solution. To ensure users can effectively harness its capabilities, OpenIM provides a suite of commands that serve different functionalities, from the API level to RPC calls and utilities.
+
+The `man` module ensures that users, both new and experienced, have a reliable source of information and documentation to use these commands effectively.
+
+## Available Commands
+
+The OpenIM commands are divided into core services and tools. Below is a brief overview of each:
+
+### Core Services
+
+- **openim-api**: Interface to the main functionalities of OpenIM.
+- **openim-cmdutils**: Utilities for executing common tasks.
+- **openim-crontask**: Schedule and manage routine tasks within OpenIM.
+- **openim-msggateway**: Gateway for managing messages within the OpenIM system.
+- **openim-msgtransfer**: Handle message transfers across different parts of OpenIM.
+- **openim-push**: Service for pushing notifications and updates.
+- **openim-rpc-auth**: RPC interface for authentication tasks.
+- **openim-rpc-conversation**: RPC service for handling conversations.
+- **openim-rpc-friend**: Manage friend lists and related functionalities through RPC.
+- **openim-rpc-group**: Group management via RPC.
+- **openim-rpc-msg**: Message handling at the RPC level.
+- **openim-rpc-third**: Third-party integrations and related tasks through RPC.
+- **openim-rpc-user**: User management and tasks via RPC.
+
+### Tools
+
+- **changelog**: Track and manage changes in OpenIM.
+- **component**: Utilities related to different components within OpenIM.
+- **infra**: Infrastructure and backend management tools.
+- **ncpu**: Monitor and manage CPU usage and related tasks.
+- **yamlfmt**: A tool for formatting and linting YAML files within the OpenIM configuration.
+
+## How to Use
+
+To view the manual page for any of the OpenIM commands, use the `man` command followed by the command name. For example:
+
+```
+man openim-api
+```
+
+## Contributions
+
+We welcome contributions to enhance the `man` pages. If you discover inconsistencies, errors, or areas where further details are required, feel free to raise an issue or submit a pull request.
@@ -0,0 +1,62 @@
+// Copyright © 2023 OpenIM. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"k8s.io/kubernetes/cmd/genutils"
+)
+
+func main() {
+	// TODO use os.Args instead of "flags" because "flags" will mess up the man pages!
+	path := "docs/man/man1"
+	module := ""
+	if len(os.Args) == 3 {
+		path = os.Args[1]
+		module = os.Args[2]
+	} else {
+		fmt.Fprintf(os.Stderr, "usage: %s [output directory] [module] \n", os.Args[0])
+		os.Exit(1)
+	}
+
+	outDir, err := genutils.OutDir(path)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "failed to get output directory: %v\n", err)
+		os.Exit(1)
+	}
+
+	// Set environment variables used by command so the output is consistent,
+	// regardless of where we run.
+	os.Setenv("HOME", "/home/username")
+
+	// openim-api
+	// openim-cmdutils
+	// openim-crontask
+	// openim-msggateway
+	// openim-msgtransfer
+	// openim-push
+	// openim-rpc-auth
+	// openim-rpc-conversation
+	// openim-rpc-friend
+	// openim-rpc-group
+	// openim-rpc-msg
+	// openim-rpc-third
+	// openim-rpc-user
+	switch module {
+	case "openim-api":
+	}
+}