agent: |
on-prem DagKnows proxy setup instructions for docker
This runbook shows how to create and install a proxy on-prem.
- 1XOart5ABuUEcKbPoMIQCRequirements
1
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.You will need a server with the following specs: * min 16GB RAM
* min 100GB disk
* min 2 CPUs * Ubuntu (20.04+)
You need to have the following packages on the VM. Most of the Linux distributions have it by default. In not, please install. * git * python (3.10+)
inputsoutputs1 - 2HiKREGxdrvKo5GqKt5AdSetup your Environment (dkproxy setup)
2
Setup your Environment (dkproxy setup)
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.inputsoutputs2- 2.1bKNkiFnFdtiEIwD4f59jCheckout this dkproxy repo.
2.1
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.inputsoutputsgit clone https://github.com/dagknows/dkproxy.gitcopied2.1 - 2.2jCIdxsiah5zbsu4G8HiNInstall required packages (dkproxy setup)
2.2
Install required packages (dkproxy setup)
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.Run the following installer. It will setup all the dependencies needed to run your proxy.
inputsoutputscd dkproxy && sh install.shcopied2.2 - 2.3KWoEKJlZqmSyfdIFnEI0Configure DagKnows CLI
2.3
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.The above installation script also installs the dagknows cli. Configure it with the following command:
inputsoutputsdk config initcopied2.3- 2.3.1lixiRZr08U3zOPHkWFWSSpecify the DagKnows server
2.3.1
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.Provide https://app.dagknows.com as the DagKnows server
Enter the api host to make api calls to:[http://localhost]: https://app.dagknows.com
hit enter
inputsoutputs2.3.1 - 2.3.2XzzZK3bTGLKpZqD17tPeCreate a token from DagKnows settings
2.3.2
Create a token from DagKnows settings
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.- Log into your DagKnows account
- Click on "Adjust Settings" in the left navigation bar
- Look for the "Generate Access Token"
- provide a label for the proxy. Like myproxy or dev or prod something. Use only alphanumeric characters.
- Specify the validity period of the token. Like 1 year or something.
- Click Generate
- This creates a row in the token table. Each row has a copy button to copy the token.
- Copy the token and use it in the next step
inputsoutputs2.3.2 - 2.3.3NIKY7oLH6mbcioG2kcj3Provide a token
2.3.3
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.Enter an access token: : <paste the token from previous step>
hit enter
That completes your DagKnows CLI config
inputsoutputs2.3.3
- 2.4bomCaY80Qm0b0NxafbWQInstall your Proxy
2.4
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.Now you can install DagKnows proxy. Just pick a proxy name, preferably the same as the label you used for the token and then run the following command. Use only alphanumeric characters.
inputsoutputssh install_proxy.sh {{PROXY_NAME}} eg: sh install_proxy.sh myproxycopied2.4
- 3lIwFktRyjeFlFe6w4IfNRun your proxy
3
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.inputsoutputs[sudo] make up logscopied3 - 4OEPcMhrVw6CNOBPrNDSHCreate roles to access credentials in proxy
4
Create roles to access credentials in proxy
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.- Log into DagKnows
- Go to Settings
- Click on the Proxies tab on the top
- Look for the table "Proxy Roles"
- Add a role label. e.g. admin, superuser etc. No special characters.
- Click Add
inputsoutputs4 - 5hX21kHSELzyuFkIxoO2UAssign the proxy role to a user
5
Assign the proxy role to a user
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.- Log into DagKnows
- Click on "User Management" in left navbar
- Click on the user ID you want to assign roles to
- Click on "Modify settings"
- On the right side the user details, look for Proxy Roles and select a role to assign on a proxy
- Click modify
- Ensure that the user now has the role assigned
inputsoutputs5 - 6VfJk0fe8lr4XEh7Ukf9DExecute a simple task on the proxy
6
Execute a simple task on the proxy
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.- Create a runbook with some simple command
- Try executing it, the command will execute on the proxy
inputsoutputs6 - 7QR3gZaldtaiDhTq1uAt5(Optional) Update your proxy
7
There was a problem that the LLM was not able to address. Please rephrase your prompt and try again.To update your proxy, simply do:
inputsoutputs[sudo] make update up logscopied7