Copilot instructions

1# GitHub Copilot Custom Instructions for Istio
2 
3This file provides repository-specific instructions for GitHub Copilot, summarizing key conventions, practices, and context from the Istio project. These guidelines are distilled from all README.md files and important documentation in the .wiki directory.
4 
5---
6 
7## Project Overview
8- **Istio** is an open source service mesh that provides a uniform way to secure, connect, and monitor microservices. It is designed to work with Kubernetes and other cluster management platforms.
9- The main components are **Envoy** (sidecar proxy), **Istiod** (control plane), and the **Operator** (CLI tool for installation and management).
10- The codebase is primarily in Go, with supporting scripts and configuration in Bash, YAML, and other languages.
11 
12## Coding Conventions
13- Follow [Effective Go](https://golang.org/doc/effective_go.html) and [Go Code Review Comments](https://github.com/golang/go/wiki/CodeReviewComments).
14- Use clear, concise comments. Follow [Go's commenting conventions](https://blog.golang.org/godoc-documenting-go-code).
15- Package names must be lowercase and match their directory. Types use CamelCase. Use singular nouns for types, plural for collections.
16- Command-line flags use dashes, not underscores.
17- Adhere to the repository's enforced lint rules for all supported languages. Go linting is run via `common/scripts/lint_go.sh` and orchestrated through `common/Makefile.common.mk` targets; see these files for details on linting entrypoints and configuration.
18 
19## Logging
20- Use the [Istio logging package](https://godoc.org/istio.io/pkg/log) for all logs.
21- Log levels: Error, Warn, Info, Debug. Errors and warnings should be actionable and clear.
22- Prefer structured logging with `WithLabels()`.
23 
24## Testing
25- Add tests for all new features and bug fixes. Use unit, integration, or end-to-end tests as appropriate.
26- Use `make test` and related targets to run tests. Coverage and race detection are encouraged.
27 
28## Performance
29- Minimize memory allocations and garbage collection pressure. Prefer value types over pointers when possible.
30- Reuse objects and use `sync.Pool` for frequently allocated types.
31- Avoid creating goroutines in the main request path; pre-create and reuse them.
32- Always measure performance before and after optimizations.
33 
34## Pull Requests
35- Communicate intent before large changes (open an issue or WIP PR).
36- PRs should be short, focused, and well-explained. Organize into logical commits.
37- Add a clear description and rationale. List all related issues.
38- Add tests for all changes.
39- Track follow-up work with issues as needed.
40 
41## Build & Development
42- Use `make build` to build all components. Use `make docker` to build container images.
43- Set environment variables: `HUB`, `TAG`, and `ISTIO` for Docker and build processes.
44- Use `make docker.push` to push images to your registry.
45- For development, see `.wiki/Preparing-for-Development.md` and `.wiki/Using-the-Code-Base.md`.
46 
47## Release Notes
48- Add release notes for all user-facing changes in `releasenotes/notes/` using the provided template.
49- Release notes should be clear, actionable, and categorized (bug-fix, feature, security, etc.).
50 
51## CNI and Operator
52- The CNI plugin manages pod networking for Istio, supporting both sidecar and ambient modes. It requires privileged permissions.
53- The Operator is now a CLI tool for installing and managing Istio via the IstioOperator API. Use profiles for configuration.
54 
55## Related Repositories
56- Other repositories in the istio organization are relevant to this repository
57- istio/api contains API definitions used by Istio components.
58- istio/istio is the main repository for Istio, which includes the control plane and data plane components.
59- istio/istio.io contains documentation and website content for Istio.
60- istio/test-infra contains testing infrastructure and scripts for Istio.
61- istio/ztunnel contains the ztunnel proxy, a secure l4 proxy for Istio Ambient mode.
62 
63## Additional Resources
64- [Project Wiki](https://github.com/istio/istio/wiki) contains detailed guides on development, conventions, and troubleshooting.
65- See `.wiki/Development-Conventions.md`, `.wiki/Writing-Fast-and-Lean-Code.md`, `.wiki/Writing-Good-Pull-Requests.md` for more details.
66 
67---
68 
69**Copilot should follow these conventions and best practices when generating code, comments, or documentation for this repository.**
70