diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..1377554
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+*.swp
diff --git a/README.md b/README.md
index 2978f0c..a74f683 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,15 @@
 # kubernetes
 
-The kubernetes package
\ No newline at end of file
+The Kubernetes module repository. This module will provide all supported versions of Kubernetes for Fedora. Forthcoming Kubernetes releases will be available once the new release reaches release candidate stage.
+
+Kubernetes releases are tracked at https://kubernetes.io/releases/ and is the canonical source for upstream lifecycle plans and status. Information on this page may be dated.
+
+|Supported Kubernetes Version | Planned End of Life |
+| :--- | ---: |
+| 1.24   | 2023.07.28 |
+| 1.23 | 2023.02.28 |
+| 1.22 | 2022.10.28 |
+
+Fedora also has specific version(s) of Kubernetes supported for each version of Fedora available as non-modular packages. See https://src.fedoraproject.org/rpms/kubernetes for non-modular package information.
+
+
diff --git a/kubernetes.yaml b/kubernetes.yaml
new file mode 100644
index 0000000..9bf1ea4
--- /dev/null
+++ b/kubernetes.yaml
@@ -0,0 +1,50 @@
+---
+document: modulemd
+version: 2
+data:
+    summary: Container cluster management
+    description: >-
+       Kubernetes is an open source system for managing
+       containerized applications across multiple hosts;
+       providing basic mechanisms for deployment, maintenance,
+       and scaling of applications. Kubernetes builds upon a
+       decade and a half of experience at Google running
+       production workloads at scale using a system called
+       Borg, combined with best-of-breed ideas and practices
+       from the community.
+    license:
+        module:
+            - ASL 2.0
+    dependencies:
+        - buildrequires:
+              platform: []
+          requires:
+              platform: []
+    references:
+        community: https://github.com/kubernetes/kubernetes
+        documentation: https://kubernetes.io
+        tracker: https://github.com/kubernetes/kubernetes
+    profiles:
+        default:
+            rpms:
+                - kubernetes
+                - kubernetes-client
+                - kubernetes-master
+                - kubernetes-node
+                - kubernetes-kubeadm
+    api:
+        rpms:
+            - kubernetes
+            - kubernetes-client
+            - kubernetes-master
+            - kubernetes-node
+            - kubernetes-kubeadm
+    buildopts:
+        rpms:
+            macros: |
+                %_with_ignore_tests 1
+    components:
+        rpms:
+            kubernetes:
+                rationale: Primary module component.
+                ref: 1.21