Skip to content

Latest commit

 

History

History
59 lines (40 loc) · 1.48 KB

README.md

File metadata and controls

59 lines (40 loc) · 1.48 KB

goawx

AWX (Ansible Tower) SDK for the Go programming language.

Please consider this code as beta right now. It could break, but I'll try my best to keep breaking changes out of the master branch. I'm working on my system tests for all endpoints.

This SDK has been developed against AWX 14.0.0.

Installing

go get -u github.com/denouche/goawx

Example

We can simply import goawx and call its services, such as the PingService:

import (
    "log"
    "github.com/denouche/goawx/client"
)

func main() {
    client, err := awx.NewAWX("http://awx.your_server_host.com", "your_awx_username", "your_awx_passwd", nil)
    if err != nil {
        log.Fatalf("AWX err: %s", err)
    }
    result, err := client.PingService.Ping()
    if err != nil {
        log.Fatalf("Ping awx err: %s", err)
    }

    log.Println("Ping awx: ", result)
}

More examples can be found at here.

Roadmap

goawx is still in development, and its roadmap could be found at here.

Contribute

There are many ways to contribute to awx-go.

Local Run

Using nektos/act for start the GitHub Workflow locally.

act -j build -P ubuntu-latest=nektos/act-environments-ubuntu:18.0