Question regarding the kubernetes agent - is their a programmatic way to “remove”/“de-register” an agent from the cloud ? I would have expected to do so using the

prefect agent

command in the cli …

Hello @Marwan Sarieddine! You can delete an agent programmatically using the GraqhQL API call with a mutation like this:

mutation {
  delete_agent(input: <agent_id>) {
    success,
    error
  }
}

Thanks @Kyle Moon-Wright! - was hoping not to write a graphql call but I guess if that’s the only way ….

you can call kubectl delete pod <POD_ID> as well

Thanks @Will Milner - there’s definitely the K8s side of the equation as well, though I think deleting the pod will just stop the Agent from polling Cloud and not fully de-register it.

good point

@Kyle Moon-Wright - sorry completely unfamiliar with graphql - to create the query - I will have to spin up a graphql server ?

@Marwan Sarieddine nope not at all! There are a few ways you can execute a graphql query, let me pull up some code rq

Sorry scratch that - I guess I should send a request to`https://api.prefect.io/graphql` somehow ?

Yup, that's correct, there's a method in

prefect.Client

that I think will make that pretty easy, one sec

@nicholas something like this?:

import prefect
client = prefect.Client()

client.graphql(
    mutation {
      delete_agent(input:<agent_id>) {
        success,
        error
      }
    }
)

You'll want to pass in the token and query args to that, but yeah! So like this:

client.graphql(
    query="mutation { delete_agent(input: agent_id) { success } }", token=api_token
)

I see - gotcha ! - thank you @nicholas @Kyle Moon-Wright

No worries at all, we're here to help!

ah gotcha - success !

Happy to help! 😄

@nicholas - as a follow up So I run

prefect agent install kubernetes

to generate the manifests - but how can I tell the agent id of the agent I just deployed ? I can query the agents to get a list of agent ids - but is there a way to tell which is the id I just created ? the only way I see is to do a diff on the list of agents before and after I deploy - but that’s quite the workaround …

I believe you can give your agent a name with the

--name <agent_name>

tag, so when you query your agents you can discern the latest one a bit easier. Without specifying, the name defaults to

agent

, if you’re seeing that in your queries at all.

Ah nice - thanks for the tip

Ah sorry @Marwan Sarieddine - the

install

command doesn't accept the

--name

flag, the

prefect agent start

command does.

ah @nicholas - I see thanks for the clarification

Yup sorry about that, we can continue in the newer thread