Deploying ADK Agents on Azure Kubernates Service (AKS)

DEV Community

To login to Azure:

az login

Then you will see a message after successful authentication:

You have logged into Microsoft Azure!
You can close this window, or we will redirect you to the Azure CLI documentation in 1 minute.

Verify The ADK Installation

To verify the setup, run the ADK CLI with Agent3:

xbill@penguin:~/gemini-cli-azure/adkui-aks$adk run Agent3
Log setup complete: /tmp/agents_log/agent.20260402_173311.log
To access latest log: tail -F /tmp/agents_log/agent.latest.log
/home/xbill/.local/lib/python3.13/site-packages/google/adk/cli/utils/agent_loader.py:277: UserWarning: [EXPERIMENTAL] _load_from_yaml_config: This feature is experimental and may change or be removed in future versions without notice. It may introduce breaking changes at any time.
 if root_agent := self._load_from_yaml_config(actual_agent_name, agents_dir):
/home/xbill/.local/lib/python3.13/site-packages/google/adk/features/_feature_decorator.py:81: UserWarning: [EXPERIMENTAL] feature FeatureName.AGENT_CONFIG is enabled.
 check_feature_enabled()
/home/xbill/.local/lib/python3.13/site-packages/google/adk/cli/cli.py:204: UserWarning: [EXPERIMENTAL] InMemoryCredentialService: This feature is experimental and may change or be removed in future versions without notice. It may introduce breaking changes at any time.
 credential_service = InMemoryCredentialService()
/home/xbill/.local/lib/python3.13/site-packages/google/adk/auth/credential_service/in_memory_credential_service.py:33: UserWarning: [EXPERIMENTAL] BaseCredentialService: This feature is experimental and may change or be removed in future versions without notice. It may introduce breaking changes at any time.
 super(). __init__ ()
Running agent studio_director, type exit to exit.

 
 
 Running the ADK Web Interface

First- start the ADK interface:



xbill@penguin:~/gemini-cli-azure/adkui-aks$adk web --host 0.0.0.0
2026年04月02日 17:33:54,016 - INFO - service_factory.py:266 - Using in-memory memory service
2026年04月02日 17:33:54,016 - INFO - local_storage.py:84 - Using per-agent session storage rooted at /home/xbill/gemini-cli-azure/adkui-aks
2026年04月02日 17:33:54,016 - INFO - local_storage.py:110 - Using file artifact service at /home/xbill/gemini-cli-azure/adkui-aks/.adk/artifacts
/home/xbill/.local/lib/python3.13/site-packages/google/adk/cli/fast_api.py:192: UserWarning: [EXPERIMENTAL] InMemoryCredentialService: This feature is experimental and may change or be removed in future versions without notice. It may introduce breaking changes at any time.
 credential_service = InMemoryCredentialService()
/home/xbill/.local/lib/python3.13/site-packages/google/adk/auth/credential_service/in_memory_credential_service.py:33: UserWarning: [EXPERIMENTAL] BaseCredentialService: This feature is experimental and may change or be removed in future versions without notice. It may introduce breaking changes at any time.
 super(). __init__ ()
INFO: Started server process [23049]
INFO: Waiting for application startup.
+-----------------------------------------------------------------------------+
| ADK Web Server started |
| |
| For local testing, access at http://0.0.0.0:8000. |
+-----------------------------------------------------------------------------+
INFO: Application startup complete.



 
 




 
 
 Connecting to the ADK

The ADK web interface is started with the place holder 0.0.0.0 address — which tells the service to listen on all interfaces. Depending on your local environment setup- you may need to use the actual local interface. There are 2 potential options:



http://0.0.0.0:8000
http://127.0.0.1:8000



 
 



This will bring up the ADK UI:
 

 
 
 Run a Sub Agent

Connect to the ADK and select "Agent3":
 
The first interaction just verifies the connection to the agent:



what do you do?
I manage a linear pipeline of four ADK Sequential Agents to transform a user's seed idea into a fully rendered, responsive HTML5 comic book. If your request starts with "Create me a comic of...", I'll delegate the task to my sub-agent to begin the comic creation pipeline. Otherwise, I'll answer your question directly.



 
 



Give the Agent this prompt:



Create a comic of Bob and Clippy in a Battle Royal with Tux.



 
 



The sub agent will then generate the comic book images:
 

 
 
 Visual Build an Agent

To use the ADK visual builder- select the pencil Icon next to Agent 2. You can drill down into the Agent design:
 

 
 
 What did I just do?

The initial steps validate that the Python code and the ADK environment is functional and that the Agent code will run correctly. The next step is to deploy this environment to the Azure Kubernates Service.

 
 
 Deploying to Azure Kubernates Service

To start the deployment:



✦ I will now run the deploy-aks.sh script 



 
 



You can validate the final result by checking the messages:



✦ The ADK application has been successfully deployed to AKS.
 Deployment Summary:
 - Deployment Status: adk-app is Ready (1/1).
 - Pod Status: adk-app-dcf865487-nbfrj is Running.
 - Service Endpoint: http://4.155.123.101 (http://4.155.123.101)
 The application is now accessible at the public IP listed above. Let me know if you need anything else!



 
 



You can then get the endpoint:



✦ The public endpoint for the ADK application is:
 4.155.123.101



 
 



The service will be visible in the Azure console:
 

 
 
 Running the ADK Web Interface

Start a connection to the Azure Deployed ADK.
This will bring up the ADK UI:
 
Select the sub-agent "Agent3" and ask the Agent to create a comic about Bit:



Bit the Raccoon is a popular, unofficial community mascot for Microsoft Azure,
specifically representing the Cloud Advocate team and open-source initiatives. 
Created by Ashley McNamara, Bit is often depicted in tech-related, helpful 
scenarios to make complex cloud concepts more accessible and approachable 
to developers. X X +2 Role: Known as the "Developer Advocate Mascot," 
Bit is often used in presentations and content to represent the "open" 
aspect of Azure. Context: While Azure has an official anime-style mascot 
in Japan (Claudia Madobe), Bit is beloved within the broader developer 
community as a fun, tech-savvy character.
Appearance: Bit is usually styled as an adorable, helpful raccoon, 
sometimes accompanied by other community mascots like "Brady the Ninja Sloth."
GitHub GitHub Bit is a favorite for stickers and frequently appears 
on social media to highlight new Azure features.
Create a story about bit



 
 



The Agent will get to work:
 

 
 
 Run the Viewer Agent

Connect to the ADK and select "Agent4":



I've exported the comic as ADK artifacts for you!
You can now view the comic directly within the ADK environment. Please check the 'Artifacts' pane or tab in your ADK Visual Builder / Studio UI.
You'll find the following:
view_full_comic.html: This is a complete, self-contained HTML file with embedded images for the full comic experience.
comic_preview.md: A markdown summary of the comic.
Individual panel images (e.g., panel_panel_1.png).
If you are working in a local terminal, you can still view the original local files by opening output/comic.html in your browser or by running ./comic.sh. However, the ADK artifacts are the best way to view it while hosted!



 
 



The Agent will generate the artifacts:
 
The Comic can then be viewed:
 

 
 
 Summary

The Agent Development Kit was used to visually define a basic agent and added a tool that calls the Image Gemini Model. This Agent was tested locally with the CLI and then with the ADK web tool. Then, the Agent was packaged and deployed to the Azure Kubernates Service. Several sample ADK agents were run directly from the deployment in Azure. This approach validates that cross cloud tools can be used — even with more complex agents.