Go で Windows サービスを作成する

目次

• はじめに
• Windows の「サービス」とは正確には何ですか?
• なぜ Golang を使うのですか?
• Go で Windows サービスを作成する
• サービスのインストールと開始
• 結論
• 完全なコード

導入

開発者の皆さん、久しぶりに Windows っぽいものを書きました。そこで、今日は Go で Windows サービス アプリケーションを作成する方法について説明したいと思います。はい、お聞きのとおり、それは Go 言語です。このチュートリアル ブログでは、Windows サービス アプリケーションに関するいくつかの基本事項を説明し、後半では、情報をファイルに記録する Windows サービスのコードを記述する簡単なコード ウォークスルーを説明します。早速、始めましょう...!

Windows の「サービス」とは正確には何ですか?

Windows サービス アプリケーション (別名 Windows サービス) は、バックグラウンドで実行される小さなアプリケーションです。通常の Windows アプリケーションとは異なり、GUI やユーザー インターフェイスはありません。これらのサービス アプリケーションは、コンピュータの起動時に実行を開始します。どのユーザー アカウントで実行されているかに関係なく実行されます。そのライフサイクル (開始、停止、一時停止、続行など) は、サービス コントロール マネージャー (SCM) と呼ばれるプログラムによって制御されます。

このことから、SCM が Windows サービスと対話し、そのライフサイクルを管理するような方法で Windows サービスを作成する必要があることがわかります。

なぜゴランなのか？

Windows サービスの作成に Go を検討する要因がいくつかあります。

同時実行性

Go の同時実行モデルにより、より高速でリソース効率の高い処理が可能になります。 Go のゴルーチンを使用すると、ブロックやデッドロックを発生させずにマルチタスクを実行できるアプリケーションを作成できます。

意味を成します。静的バイナリ

「なぜ Python のようなもっと簡単な言語を使用しないのですか?」と疑問に思うかもしれません。その理由は、Python の解釈される性質によるものです。 Go は、Windows サービスが効率的に機能するために不可欠な、静的にリンクされた単一ファイル バイナリにコンパイルします。 Go バイナリにはランタイムやインタープリターは必要ありません。 Go コードはクロスコンパイルすることもできます。

低レベルアクセス

Go はガベージ コレクション言語ではありますが、低レベルの要素と対話するための強力なサポートを提供します。 go では win32 API と一般的なシステムコールを簡単に呼び出すことができます

はい、情報は十分です。コーディングしましょう...

Go で Windows サービスを作成する

このコードのチュートリアルは、Go 構文に関する基本的な知識があることを前提としています。そうでない場合は、A Tour of Go がそれを学ぶのに最適な場所です。

• リーリー

• リーリー

• サービス インスタンスを作成するには、golang.org/x/sys/windows/svc.のハンドラー インターフェイスを実装する
Service Context
• と呼ばれるものを記述する必要があります
  インターフェイス定義は次のようになります

Execute 関数はサービスの開始時にパッケージ コードによって呼び出され、Execute が完了するとサービスは終了します。

ここで、サービス コンテキストとして機能する myService という名前のタイプを作成します。

リーリー
タイプ myService を作成した後、前述の Execute をメソッドとして追加し、Handler インターフェースを実装します。

リーリー
ハンドラー インターフェイスの実装に成功したので、実際のロジックの作成を開始できます。

• サービスが SCM から受け入れることができるシグナルを含む定数を作成します。

const cmdsAccepted = svc.AcceptStop | svc.AcceptShutdown | svc.AcceptPauseAndContinue

Our main goal is the log some data every 30 seconds. So we need to define a thread safe timer for that.

tick := time.Tick(30 * time.Second)

So, we have done all the initialization stuffs. It's time to send START signal to the SCM. we're going to do exactly that,

status <- svc.Status{State: svc.StartPending} status <- svc.Status{State: svc.Running, Accepts: cmdsAccepted}

Now we're going to write a loop which acts as amainloopfor our application. Handling events in loop makes our application never ending and we can break the loop only when the SCM sends STOP or SHUTDOWN signal.

loop: for { select { case <-tick: log.Print("Tick Handled...!") case c := <-r: switch c.Cmd { case svc.Interrogate: status <- c.CurrentStatus case svc.Stop, svc.Shutdown: log.Print("Shutting service...!") break loop case svc.Pause: status <- svc.Status{State: svc.Paused, Accepts: cmdsAccepted} case svc.Continue: status <- svc.Status{State: svc.Running, Accepts: cmdsAccepted} default: log.Printf("Unexpected service control request #%d", c) } } }

Here we used a select statement to receive signals from channels. In first case, we handle the Timer's tick signal. This case receives signal every 30 seconds, as we declared before. We log a string "Tick Handled...!" in this case.

Secondly, we handle the signals from SCM via the receive-only r channel. So, we assign the value of the signal from r to a variable c and using a switch statement, we can handle all the lifecycle event/signals of our service. We can see about each lifecycle below,

1. svc.Interrogate - Signal requested by SCM on a timely fashion to check the current status of the service.
2. svc.Stop and svc.Shutdown - Signal sent by SCM when our service needs to be stopped or Shut Down.
3. svc.Pause - Signal sent by SCM to pause the service execution without shutting it down.
4. svc.Continue - Signal sent by SCM to resume the paused execution state of the service.

So, when on receiving either svc.Stop or svc.Shutdown signal, we break the loop. It is to be noted that we need to send STOP signal to the SCM to let the SCM know that our service is stopping.

status <- svc.Status{State: svc.StopPending} return false, 1

• Now we write a function called runService where we enable our service to run either in Debug mode or in Service Control Mode.

Note: It's super hard to debug Windows Service Applications when running on Service Control Mode. That's why we are writing an additional Debug mode.

func runService(name string, isDebug bool) { if isDebug { err := debug.Run(name, &myService{}) if err != nil { log.Fatalln("Error running service in debug mode.") } } else { err := svc.Run(name, &myService{}) if err != nil { log.Fatalln("Error running service in debug mode.") } } }

• Finally we can call the runService function in our main function.

func main() { f, err := os.OpenFile("debug.log", os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666) if err != nil { log.Fatalln(fmt.Errorf("error opening file: %v", err)) } defer f.Close() log.SetOutput(f) runService("myservice", false) //change to true to run in debug mode }

Note: We are logging the logs to a log file. In advanced scenarios, we log our logs to Windows Event Logger. (phew, that sounds like a tongue twister ?)

• Now run go build to create a binary '.exe'. Optionally, we can optimize and reduce the binary file size by using the following command,

PS C:\> go build -ldflags "-s -w"

Installing and Starting the Service

For installing, deleting, starting and stopping our service, we use an inbuilt tool called sc.exe

To install our service, run the following command in powershellas Administrator,

PS C:\> sc.exe create MyService 

To start our service, run the following command,

PS C:\> sc.exe start MyService

To delete our service, run the following command,

PS C:\> sc.exe delete MyService

You can explore more commands, just type sc.exe without any arguments to see the available commands.

Conclusion

As we can see, implementing Windows Services in go is straightforward and requires minimal implementation. You can write your own windows services which acts as a web server and more. Thanks for reading and don't forget to drop a ❤️.

Complete Code

Here is the complete code for your reference.

// file: main.go package main import ( "fmt" "golang.org/x/sys/windows/svc" "golang.org/x/sys/windows/svc/debug" "log" "os" "time" ) type myService struct{} func (m *myService) Execute(args []string, r <-chan svc.ChangeRequest, status chan<- svc.Status) (bool, uint32) { const cmdsAccepted = svc.AcceptStop | svc.AcceptShutdown | svc.AcceptPauseAndContinue tick := time.Tick(5 * time.Second) status <- svc.Status{State: svc.StartPending} status <- svc.Status{State: svc.Running, Accepts: cmdsAccepted} loop: for { select { case <-tick: log.Print("Tick Handled...!") case c := <-r: switch c.Cmd { case svc.Interrogate: status <- c.CurrentStatus case svc.Stop, svc.Shutdown: log.Print("Shutting service...!") break loop case svc.Pause: status <- svc.Status{State: svc.Paused, Accepts: cmdsAccepted} case svc.Continue: status <- svc.Status{State: svc.Running, Accepts: cmdsAccepted} default: log.Printf("Unexpected service control request #%d", c) } } } status <- svc.Status{State: svc.StopPending} return false, 1 } func runService(name string, isDebug bool) { if isDebug { err := debug.Run(name, &myService{}) if err != nil { log.Fatalln("Error running service in debug mode.") } } else { err := svc.Run(name, &myService{}) if err != nil { log.Fatalln("Error running service in debug mode.") } } } func main() { f, err := os.OpenFile("E:/awesomeProject/debug.log", os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666) if err != nil { log.Fatalln(fmt.Errorf("error opening file: %v", err)) } defer f.Close() log.SetOutput(f) runService("myservice", false) }

以上がGo で Windows サービスを作成するの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。